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 |