IVMRMixerControl9 interface (vmr9.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 IVMRMixerControl9 interface enables an application to manipulate the incoming video streams on the Video Mixing Renderer Filter 9 (VMR-9). This interface is intended for use by applications only; it should not be used by upstream filters.

Inheritance

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

Methods

The IVMRMixerControl9 interface has these methods.

 
IVMRMixerControl9::GetAlpha

The GetAlpha method retrieves the constant alpha value that is applied to this video stream.
IVMRMixerControl9::GetBackgroundClr

The GetBackgroundClr method gets the current background color on the output rectangle.
IVMRMixerControl9::GetMixingPrefs

The GetMixingPrefs method retrieves the mixing preferences for the stream.
IVMRMixerControl9::GetOutputRect

The GetOutputRect method retrieves the position of this stream's video rectangle within the composition rectangle.
IVMRMixerControl9::GetProcAmpControl

The GetProcAmpControl method retrieves the current image adjustment settings for the VMR-9.
IVMRMixerControl9::GetProcAmpControlRange

The GetProcAmpControlRange method retrieves the range of values for an image adjustment setting, such as brightness, contrast, hue, or saturation.
IVMRMixerControl9::GetZOrder

The GetZOrder method retrieves this video stream's position in the Z-order.
IVMRMixerControl9::SetAlpha

The SetAlpha method sets a constant alpha value that is applied to this video stream.
IVMRMixerControl9::SetBackgroundClr

The SetBackgroundClr method sets the background color on the output rectangle.
IVMRMixerControl9::SetMixingPrefs

The SetMixingPrefs method sets the mixing preferences for the stream.
IVMRMixerControl9::SetOutputRect

The SetOutputRect method sets the position of this stream within the composition rectangle.
IVMRMixerControl9::SetProcAmpControl

The SetProcAmpControl method sets the image adjustment for the VMR-9.
IVMRMixerControl9::SetZOrder

The SetZOrder method sets this video stream's position in the Z-order; larger values are further away.

Remarks

The VMR-9 supports this interface in mixing mode only. To enable mixing mode, call IVMRFilterConfig9::SetNumberOfStreams. Otherwise, QueryInterface returns E_NOINTERFACE.

Include DShow.h and D3d9.h before Vmr9.h.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Target Platform Windows
Header vmr9.h

See also

Using the Video Mixing Renderer