Dialogic Dialogic Global Call IP IP Phone User Manual


 
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 Section 4.21.3, “Setting QoS Threshold Values”, on page 264 for code examples.
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