Siemens M20 Terminal Technical Description page 188

Siemens Information and Communication Products
8.4.2.13 UINT FAR* SetCommEventMask(idComDev, fuEvtMask)
int idComDev;
UINT fuEvtMask;
The SetCommEventMask function enables events in the event word of the specified communications device.
UINT FAR* SetCommEventMask(idComDev, fuEvtMask)
Parameter Description
idComDev Specifies the communications device to be enabled. The OpenComm function returns this value.
fuEvtMask Specifies which events are to be enabled.
This parameter can be any combination of the following values:
Value meaning
EV_BREAK set when a break is detected on input.
EV_CTS set when the CTS (clear to send) signal changes state.
EV_CTS set when the CTS (clear to send) signal changes state.
EV_CTSS set to indicate the current state of the CTS signal.
EV_DSR set when the DSR (data set ready) signal changes state.
EV_ERR set when a line-status error occurs. Line-status errors are CE_FRAME, CE_OVERRUN,
and CE_RXPARITY.
EV_PERR set when a printer error is detected on a parallel device. Errors are CE_DNS, CE_IOE,
CE_LOOP, and CE_PTO.
EV_RING set to indicate the state of ring indicator during the last modem interrupt.
EV_RLSD set when the RLSD (receive line signal detect) signal changes state.
EV_RLSDS set to indicate the current state of the RLSD signal.
EV_RXCHAR set when any character is received and placed in the receiving queue.
EV_RXFLAG set when the event character is received and placed in the receiving queue. The
event character is specified in the device's control block.
EV_TXEMPTY set when the last character in the transmission queue is sent.
Return value The return value is an indication to the event-word for the specified communications device, if the
function is successful. Each bit in the event word specifies whether a given event has occurred. A
bit is 1 if the event has occurred.
Example None
Comments Only enabled events are recorded. The GetCommEventMask function retrieves and clears the
event word.
See also GetCommEventMask, OpenComm
Version 8 dated 15.03.00
/* device to enable
/* events to enable
*/
*/
Application notes
A
188