4.14. Enabling and Disabling Unsolicited Notification Events

The application can enable and disable the GCEV_EXTENSION events associated with unsolicited notification including:

• DTMF digit detection
• Underlying protocol (Q.931 and H.245) connection state changes
• Media streaming connection state changes
• T.38 fax events

Enabling and disabling unsolicited GCEV_EXTENSION notification events is done by manipulating the event mask, which has a default value of zero, using the gc_SetConfigData( ) function. The relevant gc_SetConfigData( ) function parameter values in this context are:

• target_type - GCTGT_CCLIB_NETIF
• target_id - IPT board device
• size - Set to a value of GC_VALUE_LONG.
• target_datap - A pointer to a GC_PARM_BLK structure that contains the parameters to be configured.

The GC_PARM_BLK should contain the following parameter set ID and parameter IDs:

• IPSET_EXTENSIONEVT_MSK - the parameter set ID for all extension event parameters. The parameter ID that can be included in this set are:
  • GCACT_ADDMSK - Add an event to the mask.
  • GCACT_SUBMSK - Remove an event from the mask.
  • GCACT_SETMSK - Set the mask to a specific value.

    Possible values (corresponding to events that can be added or removed from the mask are) are:

  • EXTENSIONEVT_DTMF_ALPHANUMERIC - For notification of DTMF digits received in User Input Indication (UII) messages with alphanumeric data. When using SIP, this value is not applicable.
  • EXTENSIONEVT_DTMF_RFC2833 - For notification of DTMF digits received in the RTP stream as described in RFC 2833.
  • EXTENSIONEVT_SIGNALING_STATUS - For notification of intermediate protocol state changes in signaling (for example in H.323, Q.931 Connected and Disconnected) and control (for example in H.323, H.245 Connected and Disconnected).
  • EXTENSIONEVT_STREAMING_STATUS - For notification of the status and configuration information of transmit or receive directions of media streaming including: Tx Connected, Tx Disconnected, Rx Connected and Rx Disconnected.
  • EXTENSIONEVT_T38_STATUS - For notification of fax tones, capability frame type, info frame type, and HDLC frame type detected on T.38 fax.

Click here to contact Telecom Support Resources