SetCommMask

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

SetCommMask函数指定要监视通信设备的一组事件。

BOOL SetCommMask(

HANDLE 【HFILE】,//通讯设备的句柄
DWORD 【dwEvtMask】//掩码来标识已启用的事件
); 

参数

【HFILE】

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

【dwEvtMask】

指定要启用的事件。值为零将禁用所有事件。此参数可以是以下值的组合:

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

返回值

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

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

备注

SetCommMask函数指定可针对特定通信资源监视的事件集。可以在调用WaitCommEvent函数中指定通信资源的句柄,该函数等待发生其中一个事件。要获取通信资源的当前事件掩码,请使用GetCommMask功能。

如果SetCommMask被调用通信资源,而该资源的重叠等待待处理,则WaitCommEvent返回错误。

也可以看看

CreateFile, DCB, GetCommMask, SetCommState, WaitCommEvent