# cdiGetSignalState

Queries the current state of the supervisory signaling bits.

#### Prototype

DWORD cdiGetSignalState ( CTAHD ctahd, DWORD *pattern)

Argument | Description
ctahd | Context handle.
pattern | Pointer to the current pattern sent to the line. Refer to the Details section for more information.

#### Return values

Return value | Description
SUCCESS |
CTAERR_INVALID_CTAHD | Handle is invalid.

#### Details

pattern returned by cdiGetSignalState points to a value indicating the state of the supervisory signaling bits for a station. Possible values are:

Pattern value | Description
--- | ---
00000xxx (xxx is any value) | The bits are low (the station is on-hook).
00001xxx (xxx is any value) | The bits are high (the station is off-hook).

cdiGetSignalState is not intended for use in typical applications. The supervisory signaling is transparently controlled by the on-board DSP. Use this function when special purpose applications require explicit control of the supervisory signaling. In such cases, disable enhanced mode as described in CX 2000 modes.

Refer to Sending and receiving signaling patterns for more information.

#### See also

cdiAssertSignal