GetCommMask

【勇芳软件工作室】汉化HomePreviousNext

GetCommMask函数检索指定通信设备的事件掩码值。

BOOL GetCommMask(

HANDLE 【HFILE】,//通讯设备的句柄
LPDWORD 【lpEvtMask】//获取事件掩码的变量地址
); 

参数

【HFILE】

识别通信设备。CreateFile函数返回此句柄。

【lpEvtMask】

指向32位变量以填充当前启用的事件掩码。此参数可以是以下值中的一个或多个:

含义
EV_BREAK输入时检测到中断。
EV_CTSCTS(清除发送)信号改变状态。
EV_DSRDSR(数据设置就绪)信号改变状态。
EV_ERR发生线路状态错误。线路状态错误是CE_FRAME,CE_OVERRUN和CE_RXPARITY。
EV_EVENT1发生第一个提供者特定类型的事件。
EV_EVENT2发生第二个提供者特定类型的事件。
EV_PERR出现打印机错误。
EV_RING检测到环形指示器。
EV_RLSDRLSD(接收线路信号检测)信号改变状态。
EV_RX80FULL接收缓冲区已满80%。
EV_RXCHAR收到一个字符并放在输入缓冲区中。
EV_RXFLAG事件字符被接收并放置在输入缓冲器中。事件字符在设备的DCB结构中指定,该结构通过使用SetCommState功能应用于串行端口。
EV_TXEMPTY输出缓冲区中的最后一个字符已发送。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.

备注

GetCommMask函数使用32位掩码变量来指示可针对特定通信资源进行监视的事件集。可以在调用WaitCommEvent函数中指定通信资源的句柄,该函数等待发生其中一个事件。要修改通信资源的事件掩码,请使用SetCommMask功能。

也可以看看

CreateFile, DCB, SetCommMask, WaitCommEvent,