Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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.