3.6.3 Call Hold

The advanced call model allows the application to place a call on hold. The Global Call API provides the following functions to place a call on hold and, subsequently, to retrieve the call on hold:

gc_HoldCall( )

place a call on hold

gc_RetrieveCall( )

retrieve a call from hold

The gc_HoldCall( ) function places an active call in the On-hold (GCST_ONHOLD) state. The gc_RetrieveCall( ) function retrieves the call from the GCST_ONHOLD state and returns it to the Connected (GCST_CONNECTED) state.

Figure 26 illustrates the transition between call states when a call is put on hold and then retrieved.

Figure 26. Call State Transitions for Hold and Retrieve

Calls in the On-hold state must be returned to the Connected state before they can be dropped. Calls are dropped following the Basic Call scenario. See Section 3.4, "Basic Call Control in Asynchronous Mode" and Section 3.5, "Basic Call Control in Synchronous Mode" for more information.

Click here to contact Telecom Support Resources