Win32_SerialPortConfiguration 類別
Win32_SerialPortConfigurationWMI 類別代表 Windows 序列埠上資料傳輸的設定。 這包括建立連線和錯誤檢查的組態。
下列語法已經過受管理物件格式 (MOF) 程式碼簡化,並包含所有已繼承的屬性。 屬性會依字母順序列出,而非 MOF 順序。
語法
[Dynamic, Provider("CIMWin32"), UUID("{8502C4EB-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SerialPortConfiguration : CIM_Setting
{
string Caption;
string Description;
string SettingID;
boolean AbortReadWriteOnError;
uint32 BaudRate;
boolean BinaryModeEnabled;
uint32 BitsPerByte;
boolean ContinueXMitOnXOff;
boolean CTSOutflowControl;
boolean DiscardNULLBytes;
boolean DSROutflowControl;
boolean DSRSensitivity;
string DTRFlowControlType;
uint32 EOFCharacter;
uint32 ErrorReplaceCharacter;
boolean ErrorReplacementEnabled;
uint32 EventCharacter;
boolean IsBusy;
string Name;
string Parity;
boolean ParityCheckEnabled;
string RTSFlowControlType;
string StopBits;
uint32 XOffCharacter;
uint32 XOffXMitThreshold;
uint32 XOnCharacter;
uint32 XOnXMitThreshold;
uint32 XOnXOffInFlowControl;
uint32 XOnXOffOutFlowControl;
};
成員
Win32_SerialPortConfiguration類別具有下列類型的成員:
屬性
Win32_SerialPortConfiguration類別具有這些屬性。
-
AbortReadWriteOnError
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fAbortOnError「)
如果 為 TRUE,則會在發生錯誤時終止讀取和寫入作業。 如果 為 TRUE,則驅動程式會在發生錯誤時終止所有讀取和寫入作業,並出現錯誤狀態。 在應用程式認可錯誤之前,驅動程式將不會接受任何進一步的通訊作業。
-
-
BaudRate
-
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|BaudRate「)
傳輸 (每秒) 通訊裝置運作的速率。
範例:9600
-
-
BinaryModeEnabled
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fBinary「)
如果 為 TRUE,則會針對序列埠啟用二進位模式資料傳輸。 執行 Windows 的電腦系統只允許透過序列埠進行二進位傳輸,因此此值一律為 TRUE。
-
-
BitsPerByte
-
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|ByteSize「)
針對 Windows 序列埠的每個位元組資料傳輸和接收的位數目。 數位可能會因控制和錯誤更正位而有所不同,例如同位位。
範例:8
-
-
標題
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MaxLen (64)
目前 物件的簡短文字描述。
此屬性繼承自 CIM_Setting。
-
-
ContinueXMitOnXOff
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fTXContinueOnXoff「)
如果 為 TRUE,當輸入緩衝區位於已滿的 XOffXMitThreshold 位元組內,且驅動程式已傳輸 XOffChararcter 值以停止接收位元組時,資料傳輸會繼續。 如果 為 FALSE,則傳輸不會繼續,直到輸入緩衝區位於空白的 XOnXMitThreshold 位元組內,而且驅動程式已傳輸 XOnCharacter 值以繼續接收。
-
-
CTSOutflowControl
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fOutxCtsFlow「)
如果 為 TRUE,則會在傳輸資料之前檢查傳送 (CTS) 訊號的清除。 CTS 表示序列連線上的兩個裝置都準備好傳輸資料。 資料傳輸會暫停,直到指定 CTS 訊號為止。
-
-
說明
-
-
資料類型: 字串
-
存取類型:唯讀
目前 物件的文字描述。
此屬性繼承自 CIM_Setting。
-
-
DiscardNullBytes
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fNull「)
如果 為 TRUE,則會在收到 Null 位元組時 (字元) 捨棄。
-
-
DSROutflowControl
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fOutxDsrFlow「)
如果 為 TRUE,當資料集就緒 (DSR) 條件時,就會啟用資料流程控制。 DSR 表示連線已由序列連線上的裝置所建立。 DSR 資料傳輸會暫停,直到指定 DSR 訊號為止。
-
-
DSRSensitivity
-
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fDsrSensitivity「)
如果 為 TRUE,則通訊驅動程式會敏感于 DSR 訊號的狀態。 除非 DSR 數據機輸入線路很高,否則驅動程式會忽略任何收到的位元組。
-
-
DTRFlowControlType
-
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|fDtrControl「)
在建立連線之後,使用資料終端機 (DTR) 流程式控制制。
-
-
啟用 (「啟用」)
-
停用 (「停用」)
-
交握 (「Handshake 」)
EOFCharacter
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|EofChar「)
用來發出資料結尾訊號的字元值。
範例: ^Z
ErrorReplaceCharacter
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構|DCB|ErrorChar「)
用來取代以同位錯誤接收之位元組的字元值。
範例: ^C
ErrorReplacementEnabled
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|fErrorChar「)
如果 為 TRUE,則會以 ErrorReplaceCharacter 值取代收到同位錯誤的位元組。 只有在此屬性為 TRUE 且啟用同位時,才會取代具有同位錯誤的字元。
EventCharacter
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|EvtChar「)
用來發出事件訊號的控制字元值,例如檔案結尾。
範例: ^e
IsBusy
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|檔案函式 |CreateFile「)
如果 為 TRUE,則序列埠忙碌中。
名稱
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: key、 MaxLen (256) 、 MappingStrings (「Win32Registry|Hardware\\DeviceMap\\SerialComm「)
Windows 序列埠的名稱。
範例:「COM1」
Parity
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|同位「)
要使用的同位檢查方法。 同位會當做錯誤檢查技術使用,其中每個資料單位都會包含額外的同位位。 接收者接著可以藉由計算所設定的位來驗證資料的有效性。
None (「None」)
未使用同位檢查。
奇數 (「Odd」)
設定同位檢查位元,以便位元集計數為奇數。
偶 數 (「偶數」)
設定同位檢查位元,以便位元集計數為偶數。
Mark (「Mark」)
將同位檢查位元集保持為 1。
Space (「Space」)
將同位設定為 0 (零) 。
ParityCheckEnabled
-
資料類型: 布林值
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|fParity「)
如果 為 TRUE,則會啟用同位檢查。
RTSFlowControlType
-
資料類型: 字串
-
存取類型:唯讀
要求傳送 (RTS) 流量控制。 RTS 可用來發出資料可供傳輸的訊號。
啟用 (「Enable」)
RTS 會保留給資料傳輸會話。
停用 (「停用」)
收到第一個 RTS 訊號之後,就會忽略 RTS。
交握 (「交握 」)
如果傳輸緩衝區已滿三分之三,且當緩衝區小於一半滿時,就會關閉 RTS。
切換 (「切換」)
如果有任何資料緩衝傳輸,則會開啟 RTS。
SettingID
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MaxLen (256)
已知目前物件的識別碼。
此屬性繼承自 CIM_Setting。
StopBits
-
資料類型: 字串
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|StopBits「)
要使用的停止位數目。 停止位會分隔非同步序列連接上每個資料單位。 當沒有資料可供傳輸時,它們也會持續傳送。
1 (「1」)
1.5 (「1.5」)
2 (「2」)
XOffCharacter
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|XoffChar「)
傳輸和接收的 XOFF 字元值。 XOFF 是一種軟體控制項,可停止傳輸資料 (,而 RTS 和 CTS 則是硬體控制) 。 XON 會繼續傳輸。
XOffXMitThreshold
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|XoffLim「)
傳送 XOFF 字元之前,輸入緩衝區中允許的最大位元組數目。
XOnCharacter
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|XonChar「)
傳輸和接收的 XON 字元值。 XON 是一種軟體控制項,可繼續傳輸資料 (,而 RTS 和 CTS 則是硬體控制) 。 XOFF 會停止傳輸。
XOnXMitThreshold
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|XonLim「)
在傳送 XON 字元之前,輸入緩衝區中允許的位元組數目下限。 此屬性會與 XOffXMitThreshold 搭配運作,以規範傳輸資料的速率。
XOnXOffInFlowControl
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|fInX「)
如果 為 TRUE,則會在接收期間使用 XON/XOFF 流量控制。 如果為 TRUE,當輸入緩衝區位於已滿的XOffXMitThreshold位元組內時,就會傳送XOffCharacter值,而當輸入緩衝區位於XOnXMitThreshold位元組內時,就會傳送XOnCharacter值。
0
false
1
true
XOnXOffOutFlowControl
-
資料類型: uint32
-
存取類型:唯讀
-
限定詞: MappingStrings (「Win32API|通訊結構 |DCB|fOutX「)
XOnXOffOutFlowControl會指定傳輸期間是否使用 XON 或 XOFF 流量控制。 如果 為 TRUE,則會在收到 XOffCharacter 值時停止傳輸,並在收到 XOnCharacter 值時再次啟動。
備註
Win32_SerialPortConfiguration類別衍生自CIM_Setting。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\CIMV2 |
MOF |
|
DLL |
|
另請參閱