Dialogic Global Call IP Benutzerhandbuch
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.
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
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( )
Bearer Capability IE, then invokes gc_MakeCall( )
The Bearer Capability IE is parsed and added to the
new outgoing SETUP message.
new outgoing SETUP message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_MakeCall( )
Facility IE, then invokes gc_MakeCall( )
The Facility IE is parsed and added to the new
outgoing SETUP message.
outgoing SETUP message.
The application invokes gc_SetUserInfo( ) to set the
Bearer Capability IE and the Facility IE, then invokes
gc_MakeCall( )
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.
parsed and added to the new outgoing SETUP
message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_AnswerCall( )
Facility IE, then invokes gc_AnswerCall( )
The Facility IE is parsed and added to the new
outgoing CONNECT message.
outgoing CONNECT message.
The application invokes gc_SetUserInfo( ) to set the
Facility IE, then invokes gc_Extension( )
Facility IE, then invokes gc_Extension( )
The Facility IE is parsed and added to the new
outgoing FACILITY message.
outgoing FACILITY message.
The application receives a GCEV_OFFERED event
with a Bearer Capability IE
with a Bearer Capability IE
The application retrieves the Bearer Capability IE
using gc_GetMetaEvent( ) and
gc_util_next_parm( ).
using gc_GetMetaEvent( ) and
gc_util_next_parm( ).
The application receives a GCEV_OFFERED event
with a Facility IE
with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).
gc_GetMetaEvent( ) and gc_util_next_parm( ).
The application receives a GCEV_OFFERED event
with Bearer Capability IE and Facility IE
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( ).
Facility IE using gc_GetMetaEvent( ) and
gc_util_next_parm( ).
The application receives a GCEV_CONNECTED
event with a Facility IE
event with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).
gc_GetMetaEvent( ) and gc_util_next_parm( ).
The application receives a GCEV_EXTENSION
event with a Facility IE
event with a Facility IE
The application retrieves the Facility IE using
gc_GetMetaEvent( ) and gc_util_next_parm( ).
gc_GetMetaEvent( ) and gc_util_next_parm( ).