RTCE_MEDIA events have an IRTCMediaEvent interface. This type of event is fired when a media stream starts, stops, pauses, or resumes, or when the media is negotiated.

When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_MEDIA, the method's pEvent parameter is an IDispatch pointer for the IRTCMediaEvent interface.

Note  You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCEF_MEDIA event to enable reception of media events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.

Methods in Vtable Order

The IRTCMediaEvent interface inherits the methods of the standard COM interface IUnknown.

In addition, IRTCMediaEvent defines the following methods.

Method Description
get_MediaType Returns the media type that has changed streaming state.
get_EventType Returns the state of the media stream.
get_EventReason Returns a reason code for the media event.


Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCMediaEvent is defined as 099944fb-bcda-453e-8c41-e13da2adf7f3.