4.2.4. Setting and Retrieving Disconnect Cause or Reason Values

Use the cause parameter in the gc_DropCall( ) function to specify a disconnect reason/cause to be sent to the remote end point.

Use the gc_ResultInfo( ) function to get the reason/cause of a GCEV_DISCONNECTED event. This reason/cause could be sent from the remote end point or it could be the result of an internal error.

IP-specific reason/cause values are specified in the IPCAUSE_Values enumerator defined in the gcip_defs.h header file.

Note: The PrmStandardDisconnectReasonEnabled parameter (0x1e40) in the FCD file must be set to enable the reporting of these cause values. Failing to set this value results in the cause always being "Normal Clearing".

The following conversion macros are provided to translate reason/cause values defined by the Q.931 and H.225 standards to equivalent Global Call IP reason/cause values and vice-versa:

• H2250_REASON_TO_IPTGC_REASON(H225Reason, RetVal)
• IPTGC_REASON_TO_H2250_REASON(IPTGCReason, RetVal)
• Q931_CAUSE_TO_IPTGC_CAUSE(Q931Cause, RetVal)
• IPTGC_CAUSE_TO_Q931_CAUSE(IPTGCCause, RetVal)

Click here to contact Telecom Support Resources