Dialogic Dialogic Global Call IP IP Phone User Manual


 
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:
Overview of Parameter Usage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
Parameter Set Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
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.