Dialogic Dialogic Global Call IP IP Phone User Manual


 
Dialogic
®
Global Call IP Technology Guide — November 2007 347
Dialogic Corporation
Third Party Call Control (3PCC) Operations and Multimedia Support
Table 22 shows the inbound Dialogic
®
Global Call API events that may have SDP content
attached. The host application must register for all events that may contain SDP content. Host
applications can retrieve the SDP content by parsing the attached parameter block for IPSET_SDP
parameter IDs shown in Table 20, “IPSET_SDP Parameter Set”, on page 346.
Note: The SDP inbound content is parsed by the application. The Dialogic
®
HMP Software includes an
example SDP generator/parser. The example code is described in Section 5.3, “Session Description
Protocol Parser/Generator Example”, on page 353.
IPPARM_SDP_
OFFER
gc_SetUserInfo( ) gc_AcceptCall( ) CRN 180 Ringing or 1xx progress code
--- gc_AcceptModifyCall( ) CRN 200 OK to re-INVITE
gc_SetUserInfo( ) gc_AnswerCall( ) CRN 200 OK to INVITE
gc_SetUserInfo( ) gc_CallAck( ) CRN 100 Trying
--- gc_MakeCall( ) LD INVITE
--- gc_ReqModifyCall( ) CRN re-INVITE
IPPARM_SDP_
OPTION_ANSWER
--- gc_Extension( )
for IPEXTID_SENDMSG,
with GC_PARM_BLK
containing
IPSET_MSG_SIP /
IPPARM_MSGTYPE /
IP_MSGTYPE_SIP_
OPTIONS_OK
CRN 200 OK to OPTIONS
IPPARM_SDP_
OPTION_OFFER
-- gc_Extension( ),
for IPEXTID_SENDMSG
with GC_PARM_BLK
containing
IPSET_MSG_SIP /
IPPARM_MSGTYPE /
IP_MSGTYPE_SIP_
OPTIONS_OK
CRN OPTIONS message
Table 21. Summary of IPSET_SDP Parameters and Outbound SIP Messages (Continued)
Parameter ID Set Send
Device
Type
Outbound SIP Messages Containing
SDP
† The duration parameter must be set to GC_NEXT_OUTBOUND_MSG (to apply on next outbound message).
Table 22. Summary of Events That Support Global Call SDP Parameter Sets
Global Call Event with Possible
SDP Parameter Set Attached†
Device
Type
Inbound SIP Message with optional SDP
GCEV_ALERTING CRN 180 Ringing or 1xx progress code
GCEV_ANSWERED CRN ACK
GCEV_CANCEL_MODIFY_CALL CRN remote party responded with a 200OK when the application
sent a CANCEL request for a pending re-INVITE
GCEV_CONNECTED CRN 200 OK to INVITE
† The Global Call event may contain a pointer to an EXTENSIONEVENTBLK which contains a pointer to a parameter block.
This parameter block may contain SDP content as an IPSET_SDP parameter ID.