KsSetCommMask

此函式是否可用依装置支援项目而定。

指定要为通讯装置监视的一组事件。

语法

BOOL KsSetCommBreak(
     HANDLE hFile,
     DWORD dwEvtMask
);

参数

hFile：通讯装置的控制代码，KsCreateComm 函式回传此控制代码。

dwEvtMask：欲启用的事件，值设为零将停用所有事件。此参数可为下列一个或多个值：

值	说明
EV_BREAK 0x0040	输入侦测到中断。
EV_CTS 0x0008	清除发送 (clear-to-send, CTS) 讯号状态改变。
EV_DSR 0x0010	资料集备妥 (data-set-ready, DSR) 讯号状态改变。
EV_ERR 0x0080	发生线路状态错误。线路状态错误为 CE_FRAME、CE_OVERRUN 与CE_RXPARITY。
EV_RING 0x0100	侦测到振铃指示器。
EV_RLSD 0x0020	接收线路讯号检测 (receive-line-signal-detect, RLSD ) 讯号状态改变。
EV_RXCHAR 0x0001	字元已接收且置于输入缓冲区。
EV_RXFLAG 0x0002	事件字元已接收且置于输入缓冲区，事件字元在装置的 DCB 结构中指定，其使用 KsSetCommState 套用至串联埠。
EV_TXEMPTY 0x0004	输出缓冲区的最后一个字元已传送。

回传值

若函式执行成功将回传 TRUE；失败将回传 FALSE。欲获取延伸错误资讯请呼叫 GetLastError。

备注

KsSetCommMask 函式指定一组事件，用来监视特定的通讯资源。可在呼叫 KsWaitCommEvent 函式中指定通讯资源的处置，等待其一事件发生，欲获得当前的通讯资源的事件遮罩，请使用 KsGetCommMask 函式。

范例

N/A

使用需求

参见