Filter
Top Products
154 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
IP-Specific Operations
4.6 Receiving Notification Events
Note: The information in this section only applies when the Dialogic
®
Global Call API IP call control
library is started in the first party call control (1PCC) operating mode. The extension events that
provides the capabilities described in this section are not supported when the library is started in
the third party call control (3PCC) operating mode.
The Global Call library allows applications to receive unsolicited notification events for several
different types of state changes and other transition events.
This section includes the following topics:
• Enabling and Disabling Unsolicited Notification Events
• Getting Media Streaming Status and Connection Information
• Getting Notification of Underlying Protocol State Changes
4.6.1 Enabling and Disabling Unsolicited Notification Events
The application can enable and disable the unsolicited GCEV_EXTENSION notification events
associated with certain types of transition events, including:
• media streaming connection state changes (see Section 4.6.2, “Getting Media Streaming
Status and Connection Information”)
• underlying protocol (Q.931 and H.245) connection state changes (see Section 4.6.3, “Getting
Notification of Underlying Protocol State Changes”)
• DTMF digit detection (see Section 4.16.2, “Getting Notification of DTMF Detection”, on
page 240)
Enabling and disabling unsolicited GCEV_EXTENSION notification events is done by
manipulating the event mask, which has a default value of zero, using the gc_SetConfigData( )
function. The relevant gc_SetConfigData( ) function parameter values in this context are:
• target_type – GCTGT_CCLIB_NETIF
• target_id – IPT board device
• size – set to a value of GC_VALUE_LONG
• target_datap – a pointer to a GC_PARM_BLK structure that contains the parameters to be
configured
The GC_PARM_BLK should contain a parameter element with the
IPSET_EXTENSIONEVT_MSK set ID and one of the following parameter IDs:
GCACT_ADDMSK
Add an event to the mask
GCACT_SUBMSK
Remove an event from the mask
GCACT_SETMSK
Set the mask to a specific value