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.

Method Description
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.