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