SetCommMask函数指定要监视通信设备的一组事件。
BOOL SetCommMask(
HANDLE 【HFILE】, | //通讯设备的句柄 |
DWORD 【dwEvtMask】 | //掩码来标识已启用的事件 |
); |
参数
【HFILE】
识别通信设备。CreateFile函数返回此句柄。
【dwEvtMask】
指定要启用的事件。值为零将禁用所有事件。此参数可以是以下值的组合:
值 | 含义 |
EV_BREAK | 输入时检测到中断。 |
EV_CTS | CTS(清除发送)信号改变状态。 |
EV_DSR | DSR(数据设置就绪)信号改变状态。 |
EV_ERR | 发生线路状态错误。线路状态错误是CE_FRAME,CE_OVERRUN和CE_RXPARITY。 |
EV_RING | 检测到环形指示器。 |
EV_RLSD | RLSD(接收线路信号检测)信号改变状态。 |
EV_RXCHAR | 收到一个字符并放在输入缓冲区中。 |
EV_RXFLAG | 事件字符被接收并放置在输入缓冲器中。事件字符在设备的DCB结构中指定,该结构通过使用SetCommState功能应用于串行端口。 |
EV_TXEMPTY | 输出缓冲区中的最后一个字符已发送。 |
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
SetCommMask函数指定可针对特定通信资源监视的事件集。可以在调用WaitCommEvent函数中指定通信资源的句柄,该函数等待发生其中一个事件。要获取通信资源的当前事件掩码,请使用GetCommMask功能。
如果SetCommMask被调用通信资源,而该资源的重叠等待待处理,则WaitCommEvent返回错误。
也可以看看