KsSetCommState

此函式是否可用依裝置支援項目而定。

根據裝置控制模塊（ DCB 結構）中的規範配置通訊裝置，該函式會重新初始化所有硬體和控制設定，但不會清空輸出或輸入佇列。

語法

BOOL KsSetCommState(
     HANDLE hFile,
     LPDCB lpDCB
);

參數

hFile：通訊裝置的控制代碼，KsCreateComm 函式回傳此控制代碼。

lpDCB: ：包含指定通訊裝置配置資訊的 DCB 結構指標。

回傳值

若函式執行成功將回傳 TRUE；失敗將回傳 FALSE。欲獲取延伸錯誤資訊請呼叫 GetLastError。

備註

KsSetCommState 函式使用 DCB 結構來規定期望的配置，KsGetCommState 函式會回傳當前的配置。

僅欲設定 DCB 結構的少數成員，應修改呼叫 KsGetCommState 所填的 DCB 結構，此將確保 DCB 結構的其他成員有適當的值。

若 DCB 結構的 XonChar 成員等同於 XoffChar 成員， KsSetCommState 函式將執行失敗。

當 KsSetCommState 用來配置 8250， DCB 結構之 ByteSize 與 StopBits 成員值將受以下限制：

資料位元必須為 5 至 8 位元。

範例

N/A

使用需求

參見