Dialogic Global Call IP Benutzerhandbuch

Seite von 604
452
Dialogic
®
 Global Call IP Technology Guide — November 2007
Dialogic Corporation
Dialogic
®
 IP Media Library API Library Reference and the Dialogic
®
 IP Media Library API 
Programming Guide for more information. The thresholds supported by Dialogic
®
 Global Call 
API for HMP include:
QOSTYPE_LOSTPACKETS
QOSTYPE_JITTER
QOSTYPE_RTCPTIMEOUT
QOSTYPE_RTPTIMEOUT.
mode 
Must be set to EV_SYNC.
Note:
Applications must include the gcipmlib.h header file before Dialogic
®
 Global Call API can be 
used to set or retrieve QoS threshold values. 
See 
8.3.10
gc_GetCallInfo( ) Variances for IP
The gc_GetCallInfo( ) function can be used to retrieve calling (ANI) or called party (DNIS) 
information such as an IP address, an e-mail address, an E.164 number, a URL, or the call identifier 
(Call ID) used by the underlying protocol to globally, uniquely identify the call. The values of the 
info_id parameter that are supported for both SIP and H.323 are: 
ORIGINATION_ADDRESS 
the calling party information (equivalent to ANI) 
DESTINATION_ADDRESS 
the called party information (equivalent to DNIS) 
IP_CALLID
the globally unique identifier used by the underlying protocol to identify the call (Call ID or 
GUID)
Two additional, SIP-specific values for the info_id parameter that allow retrieval of information 
from the From URI and To URI SIP message fields are described below under the “Variance for 
SIP” heading.
When an info_id of ORIGINATION_ADDRESS (ANI) is specified and the function completes 
successfully, the valuep string is a concatenation of values delimited by a pre-determined 
character. (The delimiter character is configurable in the IPCCLIB_START_DATA data structure 
that is used by gc_Start( ); the default character is a comma.) 
When an info_id of DESTINATION_ADDRESS (DNIS) is specified and the function completes 
successfully, the valuep string is a concatenation of values delimited by a pre-determined 
character. (The delimiter character is configurable in the IPCCLIB_START_DATA data structure 
that is used by gc_Start( ); the default character is a comma.) The IP address of the destination 
gateway (that is processing the DNIS) is not included in the string. 
When an info_id of IP_CALLID (Call ID) is specified and the function completes successfully, the 
buffer pointed to by the valuep argument contains the globally unique identifier used by the 
underlying protocol to identify the call. The size and datatype of the Call ID depends on the 
protocol. To assure adequate buffer size when the protocol is unknown, use the IP_CALLIDSIZE