setCommState 函式 (winbase.h)

根據裝置控制區塊中的規格設定通訊裝置, (DCB 結構) 。 函式會重新初始化所有硬體和控制設定,但不會清空輸出或輸入佇列。

語法

BOOL SetCommState(
  [in] HANDLE hFile,
  [in] LPDCB  lpDCB
);

參數

[in] hFile

通訊裝置的句柄。 CreateFile 函式會傳回這個句柄。

[in] lpDCB

DCB 結構的指標,其中包含指定之通訊裝置的組態資訊。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。

備註

SetCommState 函式會使用DCB結構來指定所需的組態。 GetCommState 函式會傳回目前的組態。

若要只設定 DCB 結構的幾個成員,您應該修改由 GetCommState 呼叫填入的 DCB 結構。 這可確保 DCB 結構的其他成員具有適當的值。

如果DCB結構的 XonChar 成員等於 XoffChar 成員,SetCommState 函數就會失敗。

當 SetCommState 用來設定 8250 時,下列限制會套用至 DCB 結構的 ByteSize 和 StopBits 成員的值:

數據位的數目必須是5到8位。

範例

如需範例,請參閱 設定通訊資源。

規格需求

需求 值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

BuildCommDCB

通訊功能

通訊資源

CreateFile

DCB

GetCommState