Stops a call progress analysis operation.

DWORD adiStopCallProgress ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• ADIERR_INVALID_CALL_STATE
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE

• ADIEVN_CP_DONE
  Once the call progress analysis operation has been stopped, the ADI service generates a DONE event with the value field set to CTA_REASON_STOPPED.

This function disables the call progress analysis operation started by adiStartCallProgress. After this function is called, call progress analysis events will not be reported.

Call progress analysis cannot be restarted until the DONE event is received.

adiStartCallProgress

int myStopCallProgress( CTAHD ctahd )
{
 CTA_EVENT event;

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

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

        switch( event.id )
        {
            case ADIEVN_CP_DONE:
                if( event.value == CTA_REASON_RELEASED )
                    return MYDISCONNECT;    /* call has been terminated */
                else if( CTA_IS_ERROR( event.value ) )
                    return MYFAILURE;       /* API error */
                else
                    return SUCCESS;         /* stopped normally */
                break;

            /* might include cases to handle disconnect, DTMFs, etc. */
        }
    }
}