Dialogic Dialogic Global Call IP IP Phone User Manual


 
120 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
IP-Specific Operations
The defined mask values that are used to enable access to fast start coder information are:
IP_SIP_FASTSTART_CODERS_IN_OFFERED
when OR’ed into the sip_msginfo_mask field, enables application access to coder information
contained in SDP offers in SIP INVITE requests
IP_H323_FASTSTART_CODERS_IN_OFFERED
when OR’ed into the h323_msginfo_mask field, enables application access to coder
information contained in fastStart elements in H.323 Setup messages
Note: Note that it is not possible to toggle the fast start coder information access between enabled and
disabled states. Features that are enabled or configured via the IPCCLIB_START_DATA and
IP_VIRTBOARD structures cannot be disabled or reconfigured once the library has been started.
All items set in these data structures take effect when the gc_Start( ) function is called and remain
in effect until gc_Stop( ) is called when the application exits.
The following code snippet shows how an application might initialize two virtual boards to enable
basic message information access and access to fast start coder information for both SIP and H.323
protocols.
.
.
.
INIT_IPCCLIB_START_DATA(&ipcclibstart, 2, ip_virtboard);
INIT_IP_VIRTBOARD(&ip_virtboard[0]);
INIT_IP_VIRTBOARD(&ip_virtboard[1]);
ip_virtboard[0].sip_msginfo_mask =
IP_SIP_MSGINFO_ENABLE | IP_SIP_FASTSTART_CODERS_IN_OFFERED;
/* override SIP default to enable access to message info and faststart coder info*/
ip_virtboard[1].sip_msginfo_mask =
IP_SIP_MSGINFO_ENABLE | IP_SIP_FASTSTART_CODERS_IN_OFFERED;
/* override SIP default to enable access to message info and faststart coder info*/
ip_virtboard[0].h323_msginfo_mask =
IP_H323_MSGINFO_ENABLE | IP_H323_FASTSTART_CODERS_IN_OFFERED;
/* override H.323 default to enable access to message info and faststart coder info*/
ip_virtboard[1].h323_msginfo_mask =
IP_H323_MSGINFO_ENABLE | IP_H323_FASTSTART_CODERS_IN_OFFERED;
/* override H.323 default to enable access to message info and faststart coder info*/
.
.
.
4.2.5.2 Accessing “Fast Start” Coder Information
The Global Call IP call control library includes coder information in the extra data associated with
a GCEV_OFFERED event when all of the following conditions are true:
The library was started with the fast start coder information option enabled for the appropriate
protocol (as described in Section 4.2.5.1, “Enabling Access to “Fast Start” Coder
Information”).
The fast start mode is enabled (as described in Section 4.2.1, “Setting the Call Setup Mode”).
The call offer is a fast start offer; that is, it includes an SDP offer (SIP) or fastStart element
(H.323).
The SDP offer or fastStart element specifies at least one coder that the library supports.