Asserts an out-of-band signaling pattern to the line.

DWORD adiAssertSignal ( CTAHD ctahd,
unsigned pattern )

ctahd CTA context handle returned by ctaCreateContext.

pattern Bit mask to assert.

• SUCCESS
• CTAERR_FUNCTION_NOT_AVAIL
  The specified CTA context's protocol does not allow an out-of-band signaling pattern.
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE
• CTAERR_OUTPUT_ACTIVE
  The specified port is actively dialing.

None.

This function asserts the specified out-of-band signaling pattern which is either the physical out-of-band signal bits of digital lines or relates to the control of analog interface boards. In both cases, four signaling bits are addressed: A, B, C, and D, often written as ABCD, and defined by a bit mask (0x8, 0x4, 0x2, and 0x1, respectively). The following constants are in adidef.h and can be ORed to assert any group of bits: ADI_A_BIT, ADI_B_BIT, ADI_C_BIT, and ADI_D_BIT.

This function cannot be used unless the current protocol specifically allows it. CTAERR_FUNCTION_NOT_AVAIL is returned if the application invokes adiAssertSignal when disallowed by the protocol.

When using adiAssertSignal and adiStartPulse on AG Dual T/Quad T, AG 4000, or CG 6000C boards configured for D4 framing, ensure that the C bit and the D bit are set the same as the A bit and the B bit. Otherwise, the received A bit and B bit at the remote end will be in an indeterminate state.

For example, to set the A bit high and the B bit low, call adiAssertSignal as follows:

adiAssertSignal (ctahd, ADI_A_BIT | ADI_C_BIT);

When using this function with a system that includes an analog interface board, refer to the hardware reference manual for the analog interface board for specific information on how the A and B bits affect the telephone line.

adiQuerySignalState, adiStartDial, adiStartPulse

/*
 * Not using standard call control; managing actual line interface directly. 
 */

#define MY_ONHOOK   0x00
#define MY_OFFHOOK ( ADI_A_BIT | ADI_B_BIT )

void myPickUp( CTAHD ctahd )
{
 adiAssertSignal( ctahd, MY_OFFHOOK );
}

void myHangUp( CTAHD ctahd )
{
 adiAssertSignal( ctahd, MY_ONHOOK );
}