Dialogic IP Phone 05-2239-009 User Manual

444

Dialogic Corporation

Except for gc_Listen( ), gc_OpenEx( ), gc_ReleaseCallEx( ), gc_UnListen( ), all Dialogic

®

 

Global Call API functions that nominally support synchronous and asynchronous mode are 
supported only in asynchronous mode when using the IP technology. 

The Dialogic

®

 Global Call API function variances that apply when using IP technology are 

described in the following sections. See the Dialogic

 Global Call API Library Reference for 

generic (technology-independent) descriptions of the Dialogic

®

 Global Call API functions. 

This function is only supported in asynchronous mode. 

The rings parameter is ignored. 

The gc_AcceptCall( ) function is used to send the Q.931 ALERTING message to the originating 
endpoint. 

In addition to the ALERTING message, the library also generates a Q.931 PROGRESS message. 

The gc_AcceptCall( ) function is used to send a SIP informational response message to the 
originating endpoint. This message will generally be either 180 Ringing or 183 Session Progress, 
but the Dialogic

®

 Global Call API library permits any response code in the range 101-199 to be 

specified for accept call responses on a given board device. (The 100 Trying response code is not 
permitted because it is already mapped to the gc_CallAck( ) function and GCEV_PROCEEDING 
event.) If the application does not specify a particular response code for call accept messages, 180 
Ringing is used by default.

To set the SIP response code, the application calls gc_SetConfigData( ) for a board device with the 
following parameter:

IPSET_SIP_RESPONSE_CODE

IPPARM_ACCEPT_RESP_CODE

value = unsigned short between 101 and 199

The following code example shows how to set the call accept response code to 183 Session 
Progress instead of the default 180 Ringing:

   .
   .
   .
int             rc =  GC_SUCCESS;
GC_PARM_BLK *   parmblkp = NULL;
unsigned short  acceptCode = 183;  /* Session Progress*/
   .
   .