ITCallMediaEvent interface (tapi3if.h)

The ITCallMediaEvent interface contains methods that retrieve the description of media events. When the application's implementation of the ITTAPIEventNotification::Event method indicates a TAPI_EVENT equal to TE_CALLMEDIA, the method's pEvent parameter is an IDispatch pointer for the ITCallMediaEvent interface. The methods of this interface can be used to retrieve information concerning the call media event that has occurred.

Note  You must call the ITTAPI::put_EventFilter method and set an event filter mask that includes the TE_CALLMEDIA event to enable reception of call media events. If you do not call ITTAPI::put_EventFilter, your application will not receive any events. For more information, see the Events overview.

 

Inheritance

The ITCallMediaEvent interface inherits from the IDispatch interface. ITCallMediaEvent also has these types of members:

Methods

The ITCallMediaEvent interface has these methods.

ITCallMediaEvent::get_Call The get_Call method gets an ITCallInfo interface pointer for the call object associated with this event.
ITCallMediaEvent::get_Cause The get_Cause method gets the cause of the call media event, such as a timeout on the renderer device.
ITCallMediaEvent::get_Error The get_Error method gets the error associated with the media event, if any.
ITCallMediaEvent::get_Event The get_Event method gets the call media event indicator.
ITCallMediaEvent::get_Stream The get_Stream method gets a pointer to the ITStream interface associated with the call media event.
ITCallMediaEvent::get_Terminal The get_Terminal method gets the terminal associated with the event.

Requirements

Requirement	Value
Target Platform	Windows
Header	tapi3if.h (include Tapi3.h)

See also

CALLHUB_EVENT

CALL_MEDIA_EVENT

CALL_MEDIA_EVENT_CAUSE

Call Object

IDispatch

ITCallInfo

ITTAPIEventNotification::Event

Register Events code snippet

TAPI_EVENT