◄Up► ◄Next► ◄Previous► ──────────────────────────────────────────────────────────────────────────── 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). Parameter Description ──────────────────────────────────────────────────────────────────────────── 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. Return Value 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. Comments 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. ♦