Performs one of the following actions:

• Initiates connection teardown.

• Abandons call placement.

• Acknowledges a network disconnect event.

DWORD briReleaseCall ( CTAHD ctahd)

ctahd CTA context handle returned by ctaCreateContext.

• SUCCESS
• BRIERR_INVALID_CALL_STATE
• CTAERR_DRIVER_SEND_FAILED
• CTAERR_INVALID_CTAHD
• CTAERR_INVALID_STATE

• BRIEVN_CALL_RELEASED
  Generated after the BRI service has performed the network procedures for releasing the call. All internal resources allocated to the call are also released. After the application receives this event, the application must stop any media functions used on the CTA context with other boards.
• BRIEVN_STATUS_UPDATE
  Generated when some asynchronous information regarding the call (UUI information) has arrived. The event value field contains the information type.

This function is primarily used to release a connected call or to acknowledge a network disconnection. It may also be used to abandon outbound call placement.

Whenever the network disconnects a call, the BRI service sends a BRIEVN_CALL_DISCONNECTED event to the application.

After the application invokes briReleaseCall, the BRI service resets the call control state to Idle (BRI_CC_STATE_IDLE) and generates BRIEVN_CALL_RELEASED. The application is then eligible to receive or place another call.

The application can disconnect a call by invoking briReleaseCall in the placing call state (BRI_CC_STATE_PLACING_CALL), in the connected state (BRI_CC_STATE_CONNECTED), or in the answering state (BRI_CC_STATE_ANSWERING_CALL). In any case, a call released event is generated after the network release procedure completes and the BRI service resets the call control state to Idle.

BRIEVN_CALL_DISCONNECTED is not generated if release is initiated by the application.

Refer to Chapter 4 for a detailed explanation of call control.

briAcceptCall, briAnswerCall, briPlaceCall, briRejectCall

void myReleaseCall( CTAHD ctahd )
{
 CTA_EVENT event;

    briReleaseCall( ctahd );

    do 
    {
        myGetEvent( &event );           /* see ctaWaitEvent example */
    } while( event.id != BRIEVN_CALL_RELEASED );

/* Must stop the media functions (DTMF, play/record message, fax...)*/
    /* Can now place another call and/or wait for an incoming call. */
}