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