Filter
Top Products
492 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
override the default value for any fields in any of these data structures to configure the virtual
boards as desired. After the fields in the IPCCLIB_START_DATA and IP_VIRTBOARD structures
have been configured, the IPCCLIB_START_DATA structure is passed to gc_Start( ) via pointers
in CCLIB_START_STRUCT and GC_START_STRUCT data structures.
As a simple example, the following code illustrates the INIT_IPCCLIB_START_DATA( ) and
INIT_IP_VIRTBOARD( ) convenience functions being used to initialize the data structures for a
two-board system and default field values being modified to enable long parameter values, to
enable access to H.323 information elements and SIP message headers, and to enable the call
transfer supplementary service:
IP_VIRTBOARD ip_virtboard[2];
IPCCLIB_START_DATA ipcclibstart;
INIT_IPCCLIB_START_DATA(&ipcclibstart, 2, ip_virtboard);
INIT_IP_VIRTBOARD(&ip_virtboard[0]);
INIT_IP_VIRTBOARD(&ip_virtboard[1]);
ipcclibstart.max_parm_data_size = 1024; /* override 255 byte default for max parameter size */
ip_virtboard[0].sip_msginfo_mask = IP_SIP_MSGINFO_ENABLE; /* enable SIP header access */
ip_virtboard[1].sip_msginfo_mask = IP_SIP_MSGINFO_ENABLE; /* enable SIP header access */
ip_virtboard[0].h323_msginfo_mask = IP_H323_MSGINFO_ENABLE; /* enable H.323 IE access */
ip_virtboard[1].h323_msginfo_mask = IP_H323_MSGINFO_ENABLE; /* enable H.323 IE access */
ip_virtboard[0].sup_serv_mask = IP_SUP_SERV_CALL_XFER; /* override supp services default */
ip_virtboard[1].sup_serv_mask = IP_SUP_SERV_CALL_XFER; /* override supp services default */
When calling gc_Start( ) with configuration data that has been set by the application, the array of
CCLIB_START_STRUCT structures that is pointed to by GC_START_STRUCT must include two
mandatory members to start the libraries for IP call control signaling and for IP media devices. One
of these structures contains “GC_IPM_LIB” as the cclib_name field and NULL as the cclib_data
field. The other structure contains “GC_H3R_LIB” as cclib_name and a pointer to the configured
IPCCLIB_START_DATA structure as cclib_data.
Notes: 1. When using Global Gall over IP, the GC_LIB_START structure must include both the
GC_H3R_LIB and GC_IPM_LIB libraries since there are inter-dependencies.
2. The maximum value of the num_boards field is 8.
The total_max_calls, h323_max_calls, and sip_max_calls fields in the IP_VIRTBOARD structure
can be used to allocate the number and types of calls among the available devices. The following
#defines have been provided as a convenience to application developers:
IP_CFG_DEFAULT
indicates to the call control library that it should determine and fill in the correct value
IP_CFG_MAX_AVAILABLE_CALLS
indicates to the call control library that it should use the maximum available resources
Note: Do not use the value IP_CFG_MAX_AVAILABLE_CALLS with applications
running on Dialogic
®
HMP Software. That value initializes the stack for 2016
channels, which results in a lengthy initialization time and is an inefficient use of
memory and other system resources.
IP_CFG_NO_CALLS
indicates to the call control library that it should not allocate any resources
The total number of IPT devices (total_max_calls) is not necessarily equal to the number of IPT
devices used for H.323 calls (h323_max_calls) plus the number of IPT devices used for SIP calls
(sip_max_calls). Each IPT device can be used for both H.323 and SIP. For example, if there are