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 位。

有关示例，请参阅配置通信资源。