| LPWORD cevt(cid, evtmask) | |||
| int cid; | |||
| int evtmask; |
The cevt function enables events in the event mask of the specified communications device. USER calls this function whenever an application calls the SetCommEventMask function (USER.208).
cid
Identifies the communications device.
evtmask
Specifies which events are to be enabled. 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 a pointer to a 16-bit buffer if the function is successful. Otherwise, the function returns zero if there is an error.
The export ordinal for this function is 11.
The communications driver sets one or more bits in the returned buffer whenever one of the events specified by the evtmask parameter occurs.