This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Note
Access to this page requires authorization. You can trysigning in orchanging directories.
Access to this page requires authorization. You can trychanging directories.
[The feature associated with this page,DirectShow, is a legacy feature. It has been superseded byMediaPlayer,IMFMediaEngine, andAudio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code useMediaPlayer,IMFMediaEngine andAudio/Video Capture in Media Foundation instead ofDirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]
This topic applies to Windows XP or later.
In Windows XP and later, the Video Mixing Renderer 7 (VMR-7) is the default video renderer. It is called the VMR-7 because internally it uses DirectDraw 7. In DirectX 9, a similar but separate filter, the VMR-9, is available for redistribution on non-XP systems. The VMR-9 uses Direct3D 9.
Note
The VMR is available on Windows XP and later. It is not available through the DirectX redistributable, or on previous versions of Windows. For most scenarios, applications should use theVideo Mixing Renderer 9.
Features of the VMR include:
During graph building on Windows XP and later, the Filter Graph Manager will not use the older Video Renderer or Overlay Mixer filters, unless the application explicitly creates them and adds to the graph.
For more information, seeUsing the Video Mixing Renderer.
| Label | Value |
|---|---|
| Filter Interfaces | All modes:
Windowless mode: Renderless mode: Mixer mode: For information about the various VMR-7 modes, seeVMR Modes of Operation. |
| Input Pin Media Types | Major type: MEDIATYPE_VideoSubtype: Depends on the graphics hardware. Must be uncompressed video. |
| Input Pin Interfaces | |
| Output Pin Media Types | Not applicable. |
| Output Pin Interfaces | Not applicable. |
| Filter CLSID | There are two CLSIDs associated with this filter:
|
| Property Page CLSID | Not applicable. |
| Executable | Quartz.dll |
| Merit | MERIT_PREFERRED + 1 |
| Filter Category | CLSID_LegacyAmFilterCategory |
The input pin exposes theIOverlay interface only when the VMR-7 filter is in windowed mode. The onlyIOverlay method that the pin implements isGetWindowHandle, which enables an application to obtain a handle to the filter's video window. All otherIOverlay methods return E_NOTIMPL. In windowless mode, the filter does not create a video window, so the pin does not expose the interface.
An application can provide a custom allocator-presenter object that exposes the following interfaces:
For more information about custom allocator-presenters, seeSupplying a Custom Allocator-Presenter for VMR-7.
An application can also provide a custom plug-in compositor that exposes the following interface:
To configure the VMR with a custom compositor, callIVMRFilterConfig::SetImageCompositor.
Was this page helpful?
Need help with this topic?
Want to try using Ask Learn to clarify or guide you through this topic?
Was this page helpful?
Want to try using Ask Learn to clarify or guide you through this topic?