Queries the current state of the out-of-band signaling bits.

DWORD adiQuerySignalState ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_PORTID
• CTAERR_INVALID_STATE

• ADIEVN_QUERY_SIGNAL_DONE
  Once the ADI service queries the board for the current signaling pattern, the ADI service generates an event with the value field containing the current signaling pattern. It is a mask of the following constants found in adidef.h: ADI_A_BIT, ADI_B_BIT, ADI_C_BIT, and ADI_D_BIT.

This function requires that signal.dsp has been loaded for AG 24/30/48/60 boards and for AG E1/T1 boards. It is not required for the AG Quad boards. The AG 2000 board requires that signal.m54 has been loaded.

Queries the out-of-band signaling detector for the current state of the signaling bits. These signaling bits may be the actual T1/E1 digital carrier signaling bits, or they may relate to specific detectors of analog interface boards (for example, a ring detector). In both cases, the ADI service recognizes four signaling bits: A, B, C, and D, often written as ABCD, and defined by the constants ADI_A_BIT, ADI_B_BIT, ADI_BIT, and ADI_D_BIT.

When used with a protocol other than NOCC, adiQuerySignalState reports only those ABCD bits that are actually monitored by the protocol. For example, WNK0 only monitors the A bit, so BCD will always be reported as zero (0).

Note: This function may only be called if the current protocol has reserved use of the signaling bits, or if you have started detection using adiStartSignalDetector.

adiStartSignalDetector

int myShowMVIP( CTAHD ctahd )
{
        CTA_EVENT event;

    if( adiQuerySignalState( ctahd ) != SUCCESS )
        return MYFAILURE;

    while( 1 )
    {
        myGetEvent( &event );           /* see ctaWaitEvent example */

        switch( event.id )
        {
            case ADIEVN_QUERY_SIGNAL_DONE:
                printf( "MVIP signalling bits = 0x%x (%c%c%c%c)\n",
                        (event.value&0xf),
                        (event.value&0x8)?'A':'-', (event.value&0x4)?'B':'-',
                        (event.value&0x2)?'C':'-', (event.value&0x1)?'D':'-' );
                break;

        /* ... */
        }
    }
}