Dialogic
®
Global Call IP Technology Guide — November 2007 493
Dialogic Corporation
2016 devices available (total_max_calls = 2016, three Dialogic
®
IPT boards), you can specify that
all 2016 devices can be used for both H.323 calls and SIP calls (h323_max_calls = sip_max_calls =
2016), or half are used for H.323 only (h323_max_calls = 1008) and half are used for SIP only
(sip_max_calls = 1008), or any other such combination. The only restriction is that total_max_calls
must not exceed the sum of the other two parameters.
Note: When the library is started in 3PCC operating mode, both total_max_calls and sip_max_calls must
be set to a value that is no greater than the number of channels that are licensed, and
h323_max_calls should be set to 0.
The default value for the maximum number of IPT devices (total_max_calls) is 120, but this can be
set to a value up to 2016. See the reference page for IP_VIRTBOARD on page 553 for more
information.
The following restrictions apply when overriding values in the IPCCLIB_START_DATA and
IP_VIRTBOARD structures. The gc_Start( ) function will fail if these restrictions are not
observed.
• The total number of devices (total_max_calls) must not be larger than the sum of the values for
the maximum number of H.323 calls and the maximum number of SIP calls (h323_max_calls
+ sip_max_calls).
• The total number of devices (total_max_calls) cannot be set to IP_CFG_NO_CALLS.
• The maximum number of H.323 calls (h323_max_calls) and maximum number of SIP calls
(sip_max_calls) values cannot both be set to IP_CFG_NO_CALLS.
• When configuring multiple board devices, IP_CFG_DEFAULT cannot be used as an address
specifier.
• If different IP addresses or port numbers are not used when running multiple instances of an
application for any one technology (H.323 or SIP), then the xxx_max_calls (xxx = h323 or sip)
parameter for the other technology must be set to IP_CFG_NO_CALLS.
Default configuration parameter values
The following parameter values are set for a single virtual board that supports both H.323 and SIP
if NULL is passed to gc_Start( ). If this configuration is not appropriate, or if the application
requires any of the disabled features to be enabled, it must define and initialize an
IPCCLIB_START_DATA structure and an array of IP_VIRTBOARD structures, then override the
default values as necessary before passing the information to gc_Start( ).
The following parameters are set in the IPCCLIB_START_DATA structure and apply to the entire
system:
• delimiter = , [default parsing delimiter for address strings is a comma]
• num_boards = 1
• max_parm_data_size = 255
• media_operational_mode = OPERATIONAL_MODE_1PCC