GetComLineStatus

unsigned int GetComLineStatus (int COMPort);

Purpose

Returns the modem control-register values.

Linux This function is not supported.

Parameters

Input
Name Type Description
COMPort integer A number that indicates the COM port on which to operate.

This number is paired with deviceName, which represents the COM port, during the OpenComConfig function call.

Default Value: 1—COM1
Valid Range: 1—1,000

Return Value

Name Type Description
lineStatus unsigned integer Hardware-specific information about the status of the selected port.

The status word is comprised of individual bits, each with a different meaning. This parameter is filled in with a combination of the following values:

Name Value Description
kRS_CTS_ON 0x10 The CTS (clear-to-send) signal is on.
kRS_DSR_ON 0x20 The DSR (data-set-ready) signal is on.
kRS_RING_ON 0x40 The ring indicator signal is on.
kRS_RLSD_ON 0x80 The RLSD (receive-line-signal-detect) signal is on.