4.7. Getting Media Streaming Status and Negotiated Coder Information

The application can receive notification of changes in the status (connection and disconnection) of media streaming in the transmit and receive directions. When notification of the connection of the media stream in either direction is received, information about the coders negotiated for that direction is also available.

The events for this notification must be enabled; see Section 4.14, Enabling and Disabling Unsolicited Notification Events. Once the events are enabled, when a media streaming connection state changes, the application receives a GCEV_EXTENSION event. The EXTENSIONEVTBLK structure pointed to by the extevtdatap pointer within the GCEV_EXTENSION event will contain the following information:

• extID - IPEXID_MEDIAINFO
• parmblk - A GC_PARM_BLK containing protocol connection status with the following parameter set ID and one of the following parameter IDs:
  • IPSET_MEDIA_STATE - A parameter set specific to underlying protocol states.
    • IPPARM_TX_CONNECTED - Media streaming has been initiated in transmit direction. The datatype of the parameter is IP_CAPABILITY and contains the coder configuration that resulted from the capability exchange with the remote peer.
    • IPPARM_TX_DISCONNECTED - Media streaming has been terminated in transmit direction. The parameter value is not used.
    • IPPARM_RX_CONNECTED - Media streaming has been initiated in receive direction. The datatype of the parameter is IP_CAPABILITY and contains the coder configuration that resulted from the capability exchange with the remote peer.
    • IPPARM_RX_DISCONNECTED - Media streaming has been terminated in receive direction. The parameter value is not used.

Click here to contact Telecom Support Resources