IRTCMediaEvent
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. |
Requirements
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.