Stops the generation of tones.

DWORD adiStopTones ( CTAHD ctahd )

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• CTAERR_FUNCTION_NOT_ACTIVE
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_SEQUENCE
• CTAERR_INVALID_STATE

• ADIEVN_TONES_DONE
  When the tone generation function is stopped, the ADI service generates a DONE event with the value (reason) CTA_REASON_STOPPED.

This function terminates tone generation started by either adiStartTones or adiStartDTMF.

The tone generation functions, and any other functions requiring voice output, cannot be restarted until the DONE event is received.

adiStartTones, adiStartDTMF

int myStopTones( CTAHD ctahd )
{
 CTA_EVENT event;

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

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

        switch( event.id )
        {
            case ADIEVN_TONES_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. */
        }
    }
}