Dialogic Dialogic Global Call IP IP Phone User Manual


 
255
Dialogic Corporation
Retrieving TSMs from Alerting, Connected, Proceeding,
ReleaseComplete, and Setup Messages
To retrieve TSM after receiving a Global Call state change event corresponding to an Alerting,
Connected, Proceeding, ReleaseComplete, or Setup message, the application first constructs a
GC_PARM_BLK that specifies the type of information it wishes to retrieve, then calls the
gc_Extension( ) function to request the information.
The GC_PARM_BLK must contain the following two parameter elements:
IPSET_TUNNELEDSIGNALMSG
IPPARM_TUNNELEDSIGNALMSG_CONTENT
value is unused; set to 1
IPSET_TUNNELEDSIGNALMSG
IPPARM_TSM_CONTENT_EVENT
value = appropriate TSM_CONTENT_... tag value as listed in Table 17
When the application calls gc_Extension( ), the parameters should be set up as follows:
target_type must be GCTGT_GCLIB_CRN
target_id must be a valid CRN
ext_id must be IPEXTID_GETINFO
parmblkp must point to the GC_PARM_BLK that was configured to contain the required
parameter element as just described.
retblkp must be a valid pointer to a GC_PARM_BLK
mode must be EV_ASYNC
If the received H.225 message contained a tunneled signaling message, the library generates an
asynchronous GCEV_EXTENSIONCMPLT completion event. The extevtdatap field in the
METAEVENT structure for this event is a pointer to an EXTENSIONEVTBLK structure, which in
turn contains a GC_PARM_BLK that contains the fields of the received tunneled signaling
Table 17. H.225 Messages and Global Call Events for Receiving Tunneled Signaling
Messages
H.225 message
Global Call event used
to notify application
Tag used to retrieve message fields
via GCEV_EXTENSIONCMPLT
Setup GCEV_OFFERED TSM_CONTENT_OFFERED
Proceeding GCEV_PROCEEDING † TSM_CONTENT_PROCEEDING
Alerting GCEV_ALERTING TSM_CONTENT_ALERTING
Connected GCEV_CONNECTED TSM_CONTENT_CONNECTED
Release Complete GCEV_DISCONNECTED TSM_CONTENT_DISCONNECTED
Facility GCEV_EXTENSION TSM_CONTENT_EXTENSION
† The GCEV_PROCEEDING event is maskable. When Tunneled Signalling Messages are enabled, the
application must ensure that this event is not masked.