description | ms.assetid | title | ms.topic | ms.date |
---|---|---|---|---|
EVR Media Type Negotiation |
3a12b80d-7aac-437d-b515-aab37c1e81b2 |
EVR Media Type Negotiation |
article |
05/31/2018 |
[The component described on this page, Enhanced Video Renderer, is a legacy feature. It has been superseded by the Simple Video Renderer (SVR) exposed through the MediaPlayer and IMFMediaEngine components. To play video content you should send data into one of these components and allow them to instantiate the new video renderer. These components have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer or the lower level IMFMediaEngine APIs to play video media in Windows instead of the EVR, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
This topic describes how the enhanced video renderer (EVR) validates media types.
-
For the DirectShow EVR filter, type negotiation occurs when the filter's pins are connected.
-
For the EVR media sink, the media types are set through the IMFMediaTypeHandler interface on the stream sinks. Typically the topology loader negotiates the media types, although the application can also set the media types directly.
The EVR does not report any preferred media types. The client must test media types until it finds an acceptable type. The media type for the reference stream must be set before the types can be set on any of the substreams.
For the reference stream, the EVR mixer gets a list of compatible DirectX Video Acceleration (DXVA) render target formats. The EVR presenter uses this list to select the format for the Direct3D swap chain. If no compatible render target format can be found, the EVR rejects the media type.
For the substreams, the EVR mixer queries whether the DXVA device supports that substream format in combination with the render target format that was selected for the reference stream. As a result, the available substream formats might change depending on the reference stream.
Here is the process in more detail. These details are not important for most applications, but might be helpful if you are writing a custom mixer or presenter.
For the reference stream, negotiation happens as follows:
-
The EVR calls IMFTransform::SetInputType on the mixer.
-
The mixer converts the media type to a DXVA 2.0 description, using the DXVA2_VideoDesc structure.
-
The mixer calls IDirectXVideoProcessorService::GetVideoProcessorDeviceGuids to get a list of video processor GUIDs.
-
For each video processor GUID, the mixer calls IDirectXVideoProcessorService::GetVideoProcessorRenderTargets to get the supported render target formats.
-
The EVR calls IMFVideoPresenter::ProcessMessage on the presenter with the MFVP_MESSAGE_INVALIDATEMEDIATYPE message. This message causes the presenter to select a new format.
-
The presenter calls IMFTransform::GetOutputAvailableType to get a list of available output formats from the mixer. The mixer generates this list from the formats obtained in step 4.
-
The presenter selects a format and calls IMFTransform::SetOutputType on the mixer.
For substreams, the process is simpler:
-
The EVR calls IMFTransform::SetInputType on the mixer.
-
The mixer calls IDirectXVideoProcessorService::GetVideoProcessorSubStreamFormats to get a list of available substream formats.
-
If the proposed format is contained in this list, the EVR accepts the input type.