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	CIMWin32.mof
DLL	CIMWin32.dll

另請參閱

CIM_Setting

電腦系統硬體類別