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

使用需求

参见