Dialogic Dialogic Global Call IP IP Phone User Manual


 
Dialogic
®
Global Call IP Technology Guide — November 2007 171
Dialogic Corporation
IP-Specific Operations
Note: The application must retrieve the necessary IEs by copying them into its own buffer before the next
call to gc_GetMetaEvent( ). Once the next gc_GetMetaEvent( ) call is issued, the Q.931
information is no longer available.
4.8.5 Common Usage Scenarios Involving Q.931 Message IEs
Table 7 shows how the Dialogic
®
Global Call API handles common scenarios that involve the use
of Q.931 message IEs.
Table 6. Supported IEs in Incoming Q.931 Messages
Incoming Q.931
Message
Dialogic
®
Global Call
API Event
Set ID Parm ID
SETUP GCEV_OFFERED IPSET_CALLINFO IPPARM_BEARERCAP
SETUP GCEV_OFFERED IPSET_CALLINFO IPPARM_FACILITY
CONNECT GCEV_CONNECTED IPSET_CALLINFO IPPARM_FACILITY
FACILITY GCEV_EXTENSION
with an ext_id of
EXTID_RECEIVEMSG
IPSET_CALLINFO IPPARM_FACILITY
Table 7. Common Usage Scenarios Involving Q.931 Message IEs
Scenario Behavior
The application invokes gc_SetUserInfo( ) to set the
Bearer Capability IE, then invokes gc_MakeCall( )
The Bearer Capability IE is parsed and added to the
new outgoing SETUP message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_MakeCall( )
The Facility IE is parsed and added to the new
outgoing SETUP message.
The application invokes gc_SetUserInfo( ) to set the
Bearer Capability IE and the Facility IE, then invokes
gc_MakeCall( )
The Bearer Capability IE and the Facility IE are
parsed and added to the new outgoing SETUP
message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_AnswerCall( )
The Facility IE is parsed and added to the new
outgoing CONNECT message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_Extension( )
The Facility IE is parsed and added to the new
outgoing FACILITY message.
The application receives a GCEV_OFFERED event
with a Bearer Capability IE
The application retrieves the Bearer Capability IE
using gc_GetMetaEvent( ) and
gc_util_next_parm( ).
The application receives a GCEV_OFFERED event
with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).
The application receives a GCEV_OFFERED event
with Bearer Capability IE and Facility IE
The application retrieves the Bearer Capability IE and
Facility IE using gc_GetMetaEvent( ) and
gc_util_next_parm( ).
The application receives a GCEV_CONNECTED
event with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).
The application receives a GCEV_EXTENSION
event with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).