The IRTCMediaRequestEvent interface contains methods for accessing information about a media request. RTCE_MEDIA_REQUEST events are fired when the other party in an RTC 1.2 PC-PC session requests to add or remove media streams.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_MEDIA_REQUEST, the method's pEvent parameter is an IDispatch pointer for the IRTCMediaRequestEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCE_MEDIA_REQUEST event to enable reception of media request events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCMediaRequestEvent interface inherits the methods of the standard COM interfaces:
In addition, IRTCMediaRequestEvent defines the following methods.
|get_Session||Gets the IRTCSession interface for the session that generated this media request event.|
|get_ProposedMedia||Gets a set of flags describing the media types proposed by the other party in a session.|
|get_CurrentMedia||Gets a set of flags describing the media types currently streamed within a session.|
|Accept||Specifies which requested media types will be accepted.|
|get_State||Returns the state of the session reinvite.|
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCMediaRequestEvent is defined as 52572D15-148C-4d97-A36C-2DA55C289D63.