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 |