Dialogic 05-2239-009 User Manual

Page of 604
Dialogic
®
 Global Call IP Technology Guide — November 2007
143
Dialogic Corporation
IP-Specific Operations
Table 4. Retrievable Call Information
Parameter
Set ID and Parameter ID(s)
When Information 
Can Be Retrieved
Datatype in 
value_buf Field 
(see Note 1)
SIP/
H.323
Call ID
• IPPARM_CALLID
Any state after 
Offered or 
Proceeding
For SIP: string, max. 
length = MAX_IP_SIP_
CALLID_LENGTH 
For H.323: array of 
octets, length = 
MAX_IP_H323_
CALLID_LENGTH
If protocol is unknown, 
MAX_IP_CALLID_
LENGTH defines the 
maximum Call ID 
length for any possible 
protocol.
both
Bearer 
Capability IE
• IPPARM_BEARERCAP
After Offered
String, max. length = 
255
H.323 
only
Call Duration
• IPPARM_CALL_DURATION
After Disconnected, 
before Idle
Unsigned long (value 
in ms) 
H.323 
only
Conference 
Goal
• IPPARM_CONFERENCE_GOAL
Any state after 
Offered or 
Proceeding
Uint[8]
H.323 
only
Conference 
ID
• IPPARM_CONFERENCE_ID
Any state after 
Offered or 
Proceeding
char*, max. length = 
IP_CONFER
ENCE_ID_
LENGTH (16)
H.323 
only
Display 
Information
• IPPARM_DISPLAY
Any state after 
Offered or 
Proceeding
char*, max. length 
= MAX_DISPLAY_
LENGTH (82), null-
terminated
both
Facility IE
• IPPARM_FACILITY
After Offered 
(SETUP message), 
Connected 
(CONNECT 
message), or the 
reception of a 
Facility message
String, 
max. length = 255
H.323 
only
Notes
1. This field is the value_buf field in the GC_PARM_DATA structure associated with the GCEV_EXTENSIONCMPLT event 
generated in response to the gc_Extension( ) function requesting the information.
2. Display information, user to user information, phone list, nonstandard data, vendor information and nonstandard control 
information, and H221 nonstandard information may not be present.
3.Vendor information is included in a Q931 SETUP message received from a peer.
4. The nonstandard object id and nonstandard data parameters described here refer to nonstandard data contained in a 
SETUP message for example. This should not be confused with the nonstandard data included in protocol messages sent 
using gc_Extension( ) which can be retrieved from the metaevent associated with a GCEV_EXTENSION event.