IVMRFilterConfig interface (strmif.h)

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The IVMRFilterConfig interface is used to configure the operating mode and video rendering mechanisms of the Video Mixing Renderer Filter 7 (VMR-7). For the VMR-9, use the IVMRFilterConfig9 interface.

Applications must add the VMR to the graph and configure it before connecting it to any upstream filters (for example, in a call to IGraphBuilder::RenderFile). Once a filter has been connected to the VMR, the VMR's configuration is locked and all future attempts to alter it fail.

Inheritance

The IVMRFilterConfig interface inherits from the IUnknown interface. IVMRFilterConfig also has these types of members:

Methods

The IVMRFilterConfig interface has these methods.

 
IVMRFilterConfig::GetNumberOfStreams

The GetNumberOfStreams method retrieves the number of input streams being mixed.
IVMRFilterConfig::GetRenderingMode

The GetRenderingMode method retrieves the rendering mode currently being used by the VMR.
IVMRFilterConfig::GetRenderingPrefs

The GetRenderingPrefs method retrieves the current set of rendering preferences being used by the VMR.
IVMRFilterConfig::SetImageCompositor

The SetImageCompositor method installs an application-provided image compositor.
IVMRFilterConfig::SetNumberOfStreams

The SetNumberOfStreams method sets the number of streams to be mixed and instructs the VMR to go into mixer mode.
IVMRFilterConfig::SetRenderingMode

The SetRenderingMode method sets the rendering mode used by the VMR.
IVMRFilterConfig::SetRenderingPrefs

The SetRenderingPrefs method sets various application preferences related to video rendering.

Requirements

Requirement Value
Minimum supported client Windows XP with SP1 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header strmif.h (include Dshow.h)

See also

Using the Video Mixing Renderer