Dialogic IP Phone 05-2239-009 User Manual

Page of 604
Dialogic
®
 Global Call IP Technology Guide — November 2007
499
Dialogic Corporation
9
9.
IP-Specific Parameters
This chapter describes the Dialogic
®
 Global Call API parameter set IDs and parameter IDs (parm 
IDs) that are used with IP technology. Topics include: 
The “Overview of Parameter Usage” section presents information on when and how each 
parameter can be set, sent, and retrieved. The subsections in the “Parameter Set Reference” provide 
details on the types, values, and use of each individual parameter in each parameter set.
9.1
Overview of Parameter Usage
The parameter set IDs and parameter IDs described in this chapter are defined in the gcip.h header 
file. Table 42 summarizes the parameter sets and parameters used by Dialogic
®
 Global Call API in 
an IP environment, organized alphabetically by set ID and then by parameter ID. 
The meaning of the columns in Table 42 are: 
Set ID – An identifier for a group of related parameters. 
Parameter ID – An identifier for a specific parameter. 
Set – Indicates the Dialogic
®
 Global Call API functions used to set the parameter information 
in the library. Parameters that affect the operation of the board or the Dialogic
®
 Global Call 
API library will have only a Set entry. Parameters that are sent to a peer endpoint will also have 
a Send entry. 
Send – Indicates the Dialogic
®
 Global Call API functions used to send the information to a 
peer endpoint. 
Retrieve – Indicates the Dialogic
®
 Global Call API function or event used to retrieve 
information that was sent by a peer endpoint. 
H.323/SIP – Indicates if the parameter is supported when using H.323, SIP (1PCC and/or 
3PCC mode), or both H.323 and SIP. 
Table 42. Summary of Parameter Sets and Parameter Usage
Set ID
Parameter ID
Set
Send
Retrieve
SIP/
H.323
GCSET_
CALL_CONFIG
GCPARM_
CALLPROC
gc_SetConfigData( ) ---
---
both
GCSET_
CHAN_
CAPABILITY
IPPARM_
LOCAL_CAPABILITY
gc_SetConfigData( )  
gc_SetUserInfo( ) † 
gc_AnswerCall( ) 
gc_MakeCall( ) 
gc_Extension( ) 
(IPEXTID_GETINFO)
H.323, 
SIP 
1PCC
† The duration parameter can be set to GC_SINGLECALL (to apply on a call basis) or to GC_ALLCALLS (to apply on a line device basis). 
‡ Tunneling for incoming calls can only be specified using the gc_SetConfigData( ) function with a board device target ID.