Stops the DTMF detector.

DWORD adiStopDTMFDetector( CTAHD ctahd )

ctahd Context handle returned by adiOpenPort.

• SUCCESS
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_SEQUENCE
• CTAERR_INVALID_STATE

• ADIEVN_DTMF_DETECT_DONE
  Once the detector has stopped, AG Access generates a DONE event with the value field set to CTA_REASON_STOPPED.

This function disables detection of DTMFs. Detection is generally enabled automatically by the call control protocols upon transition to the ADI_CC_STATE_CONNECTED state. After this function is called, DTMF events will not be reported. The detector may be restarted with adiStartDTMFDetector. The DTMF detector cannot be restarted until the DONE event is received.

Note: The digit collection function, adiCollectDigits, will not work if you disable DTMF detection. No digits will be collected and no events will be generated.

adiStartDTMFDetector

int myStopDTMFDetector( CTAHD ctahd )
{
    ADI_EVENT event;

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

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

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

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