INtime SDK Help
GetCommMask (Serial Communications)
INtime SDK v7.1 > About INtime > Networking and I/O > Serial Communications (COMM) > GetCommMask (Serial Communications)

Retrieves the value of the event mask for a specified communications device.

BOOLEAN GetCommMask(
  COMMHANDLE hComm,      // handle to communications device
  LPDWORD lpEvtMask      // event mask
);

Parameters

hComm
[in] Handle to the communications device. OpenComm returns this handle.
lpEvtMask
[out] Pointer to the variable to be filled with a mask of events that are currently enabled. This parameter can be one or more of the following values.
Value Description
EV_BREAK A break was detected on input.
EV_CTS The CTS (clear-to-send) signal changed state.
EV_DSR The DSR (data-set-ready) signal changed state.
EV_ERR A line-status error occurred. Line-status errors are CE_FRAME, CE_OVERRUN, and CE_RXPARITY.
EV_EVENT1 An event of the first provider-specific type occurred.
EV_EVENT2 An event of the second provider-specific type occurred.
EV_PERR A printer error occurred.
EV_RING A ring indicator was detected.
EV_RLSD The RLSD (receive-line-signal-detect) signal changed state.
EV_RX80FULL The receive buffer is 80 percent full
EV_RXCHAR A character was received and placed in the input buffer.
EV_RXFLAG The event character was received and placed in the input buffer. The event character is specified in the device's DCB structure, which is applied to a serial port by using SetCommState.
EV_TXEMPTY The last character in the output buffer was sent.

Return Values

Non-zero
Success.
0 (zero)
Failure. To determine the status, call GetLastRtError.

Status

E_PARAM
Invalid parameter
E_DISCONNECTED
COMM channel is closed

Remarks

GetCommMask uses a mask variable to indicate the set of events that can be monitored for a particular communications resource. A handle to the communications resource can be specified in a call to WaitCommEvent, which waits for one of the events to occur. To modify the event mask of a communications resource, use SetCommMask.

Requirements

Requirements

Versions Defined in Include Link to
INtime 3.1 intime/rt/include/comm.h comm.h comm.lib
See Also