GetCommMask函数检索指定通信设备的事件掩码值。
BOOL GetCommMask(
HANDLE 【HFILE】, | //通讯设备的句柄 |
LPDWORD 【lpEvtMask】 | //获取事件掩码的变量地址 |
); |
参数
【HFILE】
识别通信设备。CreateFile函数返回此句柄。
【lpEvtMask】
指向32位变量以填充当前启用的事件掩码。此参数可以是以下值中的一个或多个:
值 | 含义 |
EV_BREAK | 输入时检测到中断。 |
EV_CTS | CTS(清除发送)信号改变状态。 |
EV_DSR | DSR(数据设置就绪)信号改变状态。 |
EV_ERR | 发生线路状态错误。线路状态错误是CE_FRAME,CE_OVERRUN和CE_RXPARITY。 |
EV_EVENT1 | 发生第一个提供者特定类型的事件。 |
EV_EVENT2 | 发生第二个提供者特定类型的事件。 |
EV_PERR | 出现打印机错误。 |
EV_RING | 检测到环形指示器。 |
EV_RLSD | RLSD(接收线路信号检测)信号改变状态。 |
EV_RX80FULL | 接收缓冲区已满80%。 |
EV_RXCHAR | 收到一个字符并放在输入缓冲区中。 |
EV_RXFLAG | 事件字符被接收并放置在输入缓冲器中。事件字符在设备的DCB结构中指定,该结构通过使用SetCommState功能应用于串行端口。 |
EV_TXEMPTY | 输出缓冲区中的最后一个字符已发送。 |
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
GetCommMask函数使用32位掩码变量来指示可针对特定通信资源进行监视的事件集。可以在调用WaitCommEvent函数中指定通信资源的句柄,该函数等待发生其中一个事件。要修改通信资源的事件掩码,请使用SetCommMask功能。
也可以看看