Edit

Share via

VMRRenderPrefs 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 VMRRenderPrefs enumeration type is used with the IVMRFilterConfig::GetRenderingPrefs and IVMRFilterConfig::SetRenderingPrefs methods to get and set basic rendering preferences.

Syntax

typedef enum VMRRenderPrefs {
  RenderPrefs_RestrictToInitialMonitor = 0,
  RenderPrefs_ForceOffscreen = 0x1,
  RenderPrefs_ForceOverlays = 0x2,
  RenderPrefs_AllowOverlays = 0,
  RenderPrefs_AllowOffscreen = 0,
  RenderPrefs_DoNotRenderColorKeyAndBorder = 0x8,
  RenderPrefs_Reserved = 0x10,
  RenderPrefs_PreferAGPMemWhenMixing = 0x20,
  RenderPrefs_Mask = 0x3f
} ;

Constants

 
RenderPrefs_RestrictToInitialMonitor
Value: 0
Not implemented; do not use.
RenderPrefs_ForceOffscreen
Value: 0x1
Indicates that the Video Mixing Renderer Filter 7 (VMR-7) should use only offscreen surfaces for rendering.
RenderPrefs_ForceOverlays
Value: 0x2
Indicates that the VMR-7 should fail if no overlay surfaces are available.
RenderPrefs_AllowOverlays
Value: 0
Indicates that the VMR-7 should use overlays if they are available. Should not be used by new applications.
RenderPrefs_AllowOffscreen
Value: 0
Indicates that the VMR-7 should use offscreen surfaces if no overlays are available. Should not be used by new applications.
RenderPrefs_DoNotRenderColorKeyAndBorder
Value: 0x8
Indicates that the application is responsible for painting the color keys.
RenderPrefs_Reserved
Value: 0x10
Reserved; do not use.
RenderPrefs_PreferAGPMemWhenMixing
Value: 0x20
Indicates that the VMR-7 should attempt to use AGP memory when allocating texture surfaces.
RenderPrefs_Mask
Value: 0x3f
Bitwise OR of all of the above flags.

Remarks

By default the VMR-7 tries to allocate DirectDraw texture surfaces from Video Memory and falls back to AGP memory if there is no Video Memory remaining to fulfill the allocation. In order for the VMR-7 to use AGP memory, the graphics card must have some basic support for blitting from AGP memory to Video Memory.

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