IVMRImageCompositor 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 IVMRImageCompositor interface is implemented by the default compositor for the Video Mixing Renderer Filter 7 (VMR-7). It must also be implemented by any plug-in compositor that an application provides for the VMR-7. The VMR-7 calls the methods on this interface to inform the Compositor that it should composite the incoming video frames into a single output frame. Applications do not use this interface.
For the VMR-9, use the IVMRImageCompositor9 interface.
Inheritance
The IVMRImageCompositor interface inherits from the IUnknown interface. IVMRImageCompositor also has these types of members:
Methods
The IVMRImageCompositor interface has these methods.
| IVMRImageCompositor::CompositeImage The CompositeImage method composites the current frames available in each input stream. |
| IVMRImageCompositor::InitCompositionTarget The InitCompositionTarget method informs the compositor that a new composition target has been created. |
| IVMRImageCompositor::SetStreamMediaType The SetStreamMediaType method sets the media type for the input stream. |
| IVMRImageCompositor::TermCompositionTarget The TermCompositionTarget method informs the compositor that the current composition target is being replaced. Compositors should perform any necessary cleanup of the composition target in this method. |
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) |