Dialogic Dialogic Global Call IP IP Phone User Manual


 
Dialogic
®
Global Call IP Technology Guide — November 2007 453
Dialogic Corporation
define to allocate a buffer that is large enough to hold any type of Call ID value (i.e., either an
H.323 array of octets or a SIP string).
Note: For outbound calls the gc_GetCallInfo( ) function can be used to retrieve valid Call ID
information only after the Proceeding state.
The gc_GetCallInfo( ) function can also be used to query the protocol used by a call. The info_id
parameter should be set to CALLPROTOCOL and the valuep parameter returns a pointer to an
integer that is one of the following values:
CALLPROTOCOL_H323
CALLPROTOCOL_SIP
Note: For an inbound call, the gc_GetCallInfo( ) function can be used to determine the protocol any time
after the GCEV_OFFERED event is received and before the GCEV_DISCONNECTED event is
received.
Variance for H.323
When retrieving calling (ANI) information, the following rules apply. Any section in the string that
includes a prefix (TA:, TEL:, or NAME:) has been inserted as an alias by the originating party. Any
section in the string that does not include a prefix has been inserted as a calling party number
(Q.931) by the originating party.
When retrieving called party (DNIS) information, the following rules apply. Any section in the
string that includes a prefix (TA:, TEL:, or NAME:) has been inserted as an alias by the originating
party. Any section in the string that does not include a prefix has been inserted as a called party
number (Q.931) by the originating party.
When retrieving Call ID information, the buffer pointed to by the valuep argument contains an
array of octets. The size of this array is IP_H323_CALLIDSIZE bytes. To assure adequate buffer
size when the protocol is unknown, use the IP_CALLIDSIZE define to create a buffer that is large
enough to hold any type of Call ID value (i.e., for either H.323 or SIP).
Variance for SIP
When retrieving calling party (ANI) or called party (DNIS) information, prefixes (such as TA:,
TEL:, and NAME:) are not used.
When retrieving calling party (ANI) information, the address is taken from the SIP From: header,
and is accessible in one of two forms by using one of the following parameter IDs in the function
call:
ORIGINATION_ADDRESS
Returns the simple origination address in the form
alice@192.168.1.10
ORIGINATION_ADDRESS_SIP
Returns a SIP-specific origination address that includes additional From URI parameters and
tags. The format used is
sip: alice@192.168.1.10;tag=0-13c4-4059c361-23d07406-72fe