Dialogic Dialogic Global Call IP IP Phone User Manual


 
272
Dialogic Corporation
illustrates how an application might increase the maximum number of registrations on the second
of two virtual boards to allow two registrations per user:
INIT_IPCCLIB_START_DATA(&ipcclibstart, 2, ip_virtboard);
INIT_IP_VIRTBOARD(&ip_virtboard[0]);
INIT_IP_VIRTBOARD(&ip_virtboard[1]);
ip_virtboard[1].sip_registrar_registrations = 240; /* override defaults no. of registrations*/
Note: Features that are enabled or configured via the IP_VIRTBOARD structure cannot be disabled or
reconfigured once the library has been started. All items set in this data structure take effect when
the gc_Start( ) function is called and remain in effect until gc_Stop( ) is called when the
application exits.
4.22.2.2 Locating a Registration Server
A Dialogic
®
Global Call API application can choose to use a known address for the registration
server (H.323 Gatekeeper or SIP Registrar) or to discover a registration server by multicasting to a
well-known address on which registration servers listen. This choice is determined by the IP
address specified as the registration address during registration.
The registration address is specified in the IPPARM_REG_ADDRESS parameter in the
IPSET_REG_INFO parameter set. The value of the IPPARM_REG_ADDRESS is an
IP_REGISTER_ADDRESS structure, which includes a reg_server field that contains the address
value. A specific range of IP addresses is reserved for multicast transmission:
If the application specifies an address in the range of multicast addresses or specifies the
default multicast address (IP_REG_MULTICAST_DEFAULT_ADDR), then registration
server discovery is selected.
If the application specifies an address outside the range of multicast addresses, then
registration with a specific server is selected.
Note: In SIP, if the reg_server field contains NULL or an invalid address, the default multicast address is
automatically used by the library.
When using the default multicast registration address, the application can specify the maximum
number of hops (connections between routers) in the max_hops field of the
IP_REGISTER_ADDRESS structure.
H.323
For H.323 registration, the port number used for RAS is one less than the port number used for
signaling. To avoid a port conflict when configuring multiple ipt board devices, do not assign
consecutive H.323 signaling port numbers to ipt board devices in the IPCCLIB_START_DATA
structure. See Section 8.3.27, “gc_Start( ) Variances for IP”, on page 491 for more information.
4.22.2.3 Registration Requests
An application uses the gc_ReqService( ) function to register with a Gatekeeper/Registrar. The
registration information in this case is included in the GC_PARM_BLK associated with the
gc_ReqService( ) function. See Section 4.22.4, “Registration Code Examples”, on page 279 for
more information.