Edit

Share via

VMRMode enumeration (strmif.h)

  • Article

[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 VMRMode enumeration type is used in calls to the IVMRFilterConfig::GetRenderingMode and IVMRFilterConfig::SetRenderingMode methods to retrieve or specify the Video Mixing Renderer Filter 7 (VMR-7) rendering mode.

Syntax

typedef enum VMRMode {
  VMRMode_Windowed = 0x1,
  VMRMode_Windowless = 0x2,
  VMRMode_Renderless = 0x4,
  VMRMode_Mask = 0x7
} ;

Constants

 
VMRMode_Windowed
Value: 0x1
Windowed mode.
VMRMode_Windowless
Value: 0x2
Windowless mode.
VMRMode_Renderless
Value: 0x4
Renderless mode.
VMRMode_Mask
Value: 0x7
Bitwise OR of all above flags; this is not a valid value to pass to SetRenderingMode.

Remarks

These modes are mutually exclusive. The VMRMode_Renderless flag means that the application is providing its own allocator-presenter, which is responsible for all drawing to the screen. The VMRMode_Windowed flag is the default mode of the VMR-7. See VMR Modes of Operation for more information on the rendering modes.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types