| WORD cevtGet(cid, evtmask) | |||
| int cid; | |||
| int evtmask; |
The cevtGet function retrieves and then clears the event mask for a communications device. USER calls this function whenever an application calls the GetCommEventMask function (USER.209).
cid
Identifies the communications device.
evtmask
Specifies which events in the current event mask to disable. This parameter can be any combination of the following values.
| Value | Meaning |
| EV_BREAK | Enables detection of a break upon input. |
| EV_CTS | Enables detection of the clear-to-send (CTS) signal. |
| EV_DSR | Enables detection of the data-set-ready (DSR) signal. |
| EV_ERR | Enables detection of a line-status error. Line-status errors are CE_FRAME, CE_OVERRUN, and CE_RXPARITY. |
| EV_PERR | Enables detection of a printer error on a parallel device. Errors are CE_DNS, CE_IOE, CE_LOOP, and CE_PTO. |
| EV_RING | Indicates the state of ring indicator during the last modem interrupt. (Use EV_RINGTE to detect when a phone ring has occurred.) |
| EV_RLSD | Enables detection of the receive-line-signal-detect (RLSD) signal. |
| EV_RXCHAR | Enables detection of any character received and placed in the receive queue. |
| EV_RXFLAG | Enables detection of the event character received and placed in the receive queue. The event character is specified in the EvtChar member of the DCB structure. |
| EV_TXEMPTY | Enables detection of when the last character in the transmit queue is sent. |
The return value is the current event word as set by the cevt function.
The export ordinal for this function is 12.