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

DWORD adiAssertSignal( CTAHD ctahd,
unsigned pattern )

ctahd Context handle returned by adiOpenPort.

pattern Bit mask to assert.

• SUCCESS
• CTAERR_FUNCTION_NOT_AVAILABLE
  The specified 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_AVAILABLE is returned if the application invokes adiAssertSignal when disallowed by the protocol.

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

adiStartPulse, adiStartDial, adiQuerySignalState

/*
 * 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 );
}