| Platform SDK: TAPI |
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.
IUnknown Methods
IDispatch Methods
| ITCallMediaEvent methods | Description |
|---|---|
| get_Call | Gets a pointer to the ITCallInfo interface. |
| get_Event | Gets the CALL_MEDIA_EVENT descriptor of an event. |
| get_Error | Gets the error associated with the media event, if any. |
| get_Terminal | Gets a pointer to the ITTerminal interface. |
| get_Stream | Gets a pointer to the ITStream interface. |
| get_Cause | Gets the CALL_MEDIA_EVENT_CAUSE for the event. |
Windows NT/2000: Requires Windows 2000.
Version: Requires TAPI 3.0 or later.
Header: Declared in Tapi3.h.
Library: Use T3iid.lib.
ITTAPIEventNotification::Event, TAPI_EVENT, ITCallInfo, CALL_MEDIA_EVENT, CALLHUB_EVENT, CALL_MEDIA_EVENT_CAUSE, Call Object