IVMRMixerControl 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 IVMRMixerControl interface is enables an application to manipulate the incoming video streams on the Video Mixing Renderer Filter 7 (VMR-7). Although this interface is implemented on the filter, it is actually the mixer component that is being configured. For this reason, this interface is only available when the mixer has been loaded through a call to IVMRFilterConfig::SetNumberOfStreams. This interface is intended for use by applications only; it should not be used by upstream filters.
For the VMR-9, use the IVMRMixerControl9 interface.
Inheritance
The IVMRMixerControl interface inherits from the IUnknown interface. IVMRMixerControl also has these types of members:
Methods
The IVMRMixerControl interface has these methods.
| IVMRMixerControl::GetAlpha The GetAlpha method retrieves the constant alpha value that is applied to this video stream. |
| IVMRMixerControl::GetBackgroundClr Gets the current background color on the output rectangle. |
| IVMRMixerControl::GetMixingPrefs Retrieves the mixing preferences for the stream. |
| IVMRMixerControl::GetOutputRect The GetOutputRect method retrieves the position of this stream's video rectangle within the composition rectangle. |
| IVMRMixerControl::GetZOrder The GetZOrder method retrieves this video stream's position in the Z order. |
| IVMRMixerControl::SetAlpha The SetAlpha method sets a constant alpha value that is applied to this video stream. |
| IVMRMixerControl::SetBackgroundClr Sets the background color on the output rectangle. |
| IVMRMixerControl::SetMixingPrefs Sets the mixing preferences for the stream. |
| IVMRMixerControl::SetOutputRect The SetOutputRect method sets the position of this stream within the composition rectangle. |
| IVMRMixerControl::SetZOrder The SetZOrder method sets this video stream's position in the Z-order; larger values are further away. |
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) |