MSP_CALL_EVENT_CAUSE

This constant is returned within the MSP_EVENT_INFO struct by the GetEvent method when MSP_EVENT is ME_CALL_EVENT.

typedef enum
{
  CALL_CAUSE_UNKNOWN,
  CALL_CAUSE_BAD_DEVICE,
  CALL_CAUSE_CONNECT_FAIL,
  CALL_CAUSE_LOCAL_REQUEST,
  CALL_CAUSE_REMOTE_REQUEST,
  CALL_CAUSE_MEDIA_TIMEOUT,
  CALL_CAUSE_MEDIA_RECOVERED
} MSP_CALL_EVENT_CAUSE;

Members

CALL_CAUSE_UNKNOWN

Call event cause is unknown.

CALL_CAUSE_BAD_DEVICE

A bad device caused failure, for either STREAM_FAIL or TERMINAL_FAIL.

CALL_CAUSE_CONNECT_FAIL

either connecting the stream failed or connecting the terminal failed. Note, if a terminal cannot be connected to a stream, the application will get a TERMINAL_FAIL event with CMC_CONNECT_FAIL. If this stream failed because the terminal is the only one to use, the application will also get a STREAM_FAIL event with CMC_CONNECT_FAIL.

CALL_CAUSE_LOCAL_REQUEST

The event is the result of the application calling a method on the stream.

CALL_CAUSE_REMOTE_REQUEST

The event is the result of the remote endpoint's request.

CALL_CAUSE_MEDIA_TIMEOUT

The media that carries the stream is temporarily not available.

CALL_CAUSE_MEDIA_RECOVERED

The media that carries the stream is back to normal from a temporary denial of service.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.

See Also

Media Service Provider Interface (MSPI), MSP_EVENT, MSP_EVENT_INFO, ITMSPAddress::GetEvent