Edit

Share via

VMRMixerPrefs 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 VMRMixerPrefs enumeration contains flags that specify decimation, filtering, and color space information that will be used when the video image is created on the DirectDraw surface.

Syntax

typedef enum VMRMixerPrefs {
  MixerPref_NoDecimation = 0x1,
  MixerPref_DecimateOutput = 0x2,
  MixerPref_ARAdjustXorY = 0x4,
  MixerPref_DecimationReserved = 0x8,
  MixerPref_DecimateMask = 0xf,
  MixerPref_BiLinearFiltering = 0x10,
  MixerPref_PointFiltering = 0x20,
  MixerPref_FilteringMask = 0xf0,
  MixerPref_RenderTargetRGB = 0x100,
  MixerPref_RenderTargetYUV = 0x1000,
  MixerPref_RenderTargetYUV420 = 0x200,
  MixerPref_RenderTargetYUV422 = 0x400,
  MixerPref_RenderTargetYUV444 = 0x800,
  MixerPref_RenderTargetReserved = 0xe000,
  MixerPref_RenderTargetMask = 0xff00,
  MixerPref_DynamicSwitchToBOB = 0x10000,
  MixerPref_DynamicDecimateBy2 = 0x20000,
  MixerPref_DynamicReserved = 0xc0000,
  MixerPref_DynamicMask = 0xf0000
} ;

Constants

 
MixerPref_NoDecimation
Value: 0x1
No decimation. The video will be rendered onto the surface in its native size.
MixerPref_DecimateOutput
Value: 0x2
Decimate output by 2 in the x and y directions.
MixerPref_ARAdjustXorY
Value: 0x4
Adjust the horizontal or vertical size of the video streams to match the target aspect ratio. If this flag is not present, the VMR adjusts the horizontal size only. For more information, see Aspect Ratio Correction.
MixerPref_DecimationReserved
Value: 0x8
Reserved.
MixerPref_DecimateMask
Value: 0xf
Bitmask to isolate the flags that control decimation. (This value is not a valid flag.)
MixerPref_BiLinearFiltering
Value: 0x10
Use bi-linear filtering. This is the default type of filtering, but not all cards can support it.
MixerPref_PointFiltering
Value: 0x20
Use point filtering.
MixerPref_FilteringMask
Value: 0xf0
Bitmask to isolate the flags the control filtering. (This value is not a valid flag.)
MixerPref_RenderTargetRGB
Value: 0x100
The render target is an RGB surface.
MixerPref_RenderTargetYUV
Value: 0x1000
The render target is a YUV surface. Requires Windows XP Service Pack 2. For more information, see YUV Mixing Mode.
MixerPref_RenderTargetYUV420
Value: 0x200
The render target is a YUV 4:2:0 surface.
Note  Deprecated.

 
MixerPref_RenderTargetYUV422
Value: 0x400
The render target is a YUV 4:2:2 surface.
Note  Deprecated.

 
MixerPref_RenderTargetYUV444
Value: 0x800
The render target is a YUV 4:4:4 surface.
Note  Deprecated.

 
MixerPref_RenderTargetReserved
Value: 0xe000
Reserved.
MixerPref_RenderTargetMask
Value: 0xff00
Bitmask to isolate flags that control the render target. (This value is not a valid flag.)
MixerPref_DynamicSwitchToBOB
Value: 0x10000
In YUV mixing mode only, this flag switches the VMR to bob deinterlacing. You can add or remove this flag while the filter graph is running; the change will be applied when the VMR mixer composes the next video frame.
MixerPref_DynamicDecimateBy2
Value: 0x20000
In YUV mixing mode only, this flag causes the VMR to decimate the image by a factor of 2 horizontally and vertically. You can add or remove this flag while the filter graph is running; the change is applied when the VMR mixer composes the next video frame.
MixerPref_DynamicReserved
Value: 0xc0000
Reserved.
MixerPref_DynamicMask
Value: 0xf0000
Bitmask to isolate the MixerPref_DynamicSwitchToBOB and MixerPref_DynamicDecimateBy2 flags. (This value is not a valid flag.)

Requirements

Requirement Value
Header strmif.h (include Dshow.h)

See also

DirectShow Enumerated Types

IVMRMixerControl::GetMixingPrefs

IVMRMixerControl::SetMixingPrefs