共用方式為


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 結構的 ByteSizeStopBits 成員的值:

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

範例

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

規格需求

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

另請參閱

BuildCommDCB

通訊功能

通訊資源

CreateFile

DCB

GetCommState