Filter
Top Products
444 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
8.3 Dialogic
®
Global Call API Function Variances for IP
Note: 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.
8.3.1 gc_AcceptCall( ) Variances for IP
This function is only supported in asynchronous mode.
The rings parameter is ignored.
Variance for H.323
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.
Variance for SIP
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*/
.
.