Dialogic IP Phone 05-2239-009 User Manual

491

Dialogic Corporation

See 

, on page 322 for more 

information and a code example.

The gc_Start( ) function is used to configure the Dialogic

®

 Global Call API library on a system 

level and on a virtual board level. 

At the system level, the following items can be configured:

the number of IPT board devices (virtual boards) to create in the system (see 

, on page 47 for the meaning of an IPT board device) 

the maximum size of parameter data for certain Global Call parameter types, such as SIP 
message headers, H.323 non-standard data, and MIME part headers

first party call control or third party call control operating mode

The maximum value of the num_boards field in the IPCCLIB_START_DATA structure, which 
defines the number of IPT board devices and the number of NIC addresses, is 8.

On a virtual board level, the application can configure a number of characteristics for each IPT 
board device. Among the major capabilities and features that can be configured for each virtual 
board when starting the system are:

the total number of IPT line devices that can be open concurrently

the maximum number of IPT devices that can be used for H.323 calls and for SIP calls

the local address and signaling port for H.323 and for SIP

enable/disable call transfer supplementary services

enable/disable access to H.323 message information fields and to SIP message header fields

enable/disable and configure access to MIME-encoded message bodies in SIP messages

enable/disable and configure SIP outbound proxy

enable/disable and configure use of TCP transport protocol for SIP messages

configure SIP request retry behavior

enable/disable application access to SIP OPTIONS messages

If NULL is passed to gc_Start( ) the system is started in a default configuration that has a single 
virtual board which supports both H.323 and SIP protocols. This virtual board will have the default 
parameters listed at the end of this section. If the default configuration is not appropriate for the 
application, if the application needs to use the third party call control operating mode, or if the 
application requires a non-default configuration for any of the parameters (for example, if it needs 
to use one or more of the features that are disabled by default), the application must explicitly 
configure the system before calling gc_Start( ). 

To configure a non-default system, the application starts by creating an 

 

structure and an array of 

 structures, one for each virtual board in the system. The 

application must then use the convenience functions 

 and 

 (defined in the gcip.h header file) to initialize each of the structures 

with the default value for each field in the structure. After initialization, the application can