Edit

Share via

OID_CO_TAPI_GET_CALL_DIAGNOSTICS

  • Article

The OID_CO_TAPI_GET_CALL_DIAGNOSTICS OID requests a call manager or MCM driver to return diagnostic information about a failed call or a call torn down by the remote TAPI party.

This request uses a CO_TAPI_CALL_DIAGNOSTICS structure, which is defined as follows:

typedef struct _CO_TAPI_CALL_DIAGNOSTICS {
    OUT ULONG               ulOrigin;
    OUT ULONG               ulReason;
    OUT NDIS_VAR_DATA_DESC  DiagInfo;
} CO_TAPI_CALL_DIAGNOSTICS, *PCO_TAPI_CALL_DIAGNOSTICS;

ulOrigin
Specifies the origination of the call as one of the following LINECALLORIGIN_ constants:

  • LINECALLORIGIN_OUTBOUND
    The call is an outgoing call.

  • LINECALLORIGIN_INTERNAL
    The call is incoming and originated internally (on the same PBX, for example).

  • LINECALLORIGIN_EXTERNAL The call is incoming and originated externally.

  • LINECALLORIGIN_UNKNOWN
    The call is incoming. Its origin is currently unknown but may become known later.

  • LINECALLORIGIN_UNAVAIL
    The call is incoming. Its origin is not available and will never be known.

  • LINECALLORIGIN_CONFERENCE
    The call handle is for a conference call--that is, for the application's connection to the conference bridge in the switch.

ulReason
Specifies the reason for the call as one of the following LINECALLREASON_ constants:

  • LINECALLREASON_DIRECT
    The call is direct.

  • LINECALLREASON_FWDBUSY
    The call was forwarded from a busy extension.

  • LINECALLREASON_FWDNOANSWER
    The call was forwarded after some number of rings from an unanswered extension.

  • LINECALLREASON_FWDUNCOND
    The call was forwarded unconditionally from another number.

  • LINECALLREASON_PICKUP
    The call was picked up from another extension.

  • LINECALLREASON_UNPARK
    The call was retrieved as a parked call.

  • LINECALLREASON_REDIRECT
    The call was redirected to this station.

  • LINECALLREASON_CALLCOMPLETION
    The call was the result of a call completion request.

  • LINECALLREASON_TRANSFER
    The call was transferred from another number. Party identifier information may indicate who the caller is and from where the call was transferred.

  • LINECALLREASON_REMINDER
    The call is a reminder (or "recall") that the user has a call parked or on hold for a potentially long time.

  • LINECALLREASON_UNKNOWN
    The reason for the call is currently unknown but may become known later.

  • LINECALLREASON_UNAVAIL
    The reason for the call is unavailable and cannot become known later.

DiagInfo
Specifies an NDIS_VAR_DATA_DESC structure that contains an offset to, as well as the length of, optional diagnostic information supplied by the call manager or MCM driver. The content and format of the diagnostic information is driver-determined.

Requirements

Version: Windows Vista and later Header: Ntddndis.h (include Ndis.h)