VMR9MixerPrefs enumeration (vmr9.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 VMR9MixerPrefs enumeration type contains flags that specify how the Video Mixing Render 9 filter (VMR-9) mixes the video streams. Settings include decimation, filtering, and render target preferences.

Syntax

typedef enum __MIDL___MIDL_itf_vmr9_0000_0005_0001 {
  MixerPref9_NoDecimation = 0x1,
  MixerPref9_DecimateOutput = 0x2,
  MixerPref9_ARAdjustXorY = 0x4,
  MixerPref9_NonSquareMixing = 0x8,
  MixerPref9_DecimateMask = 0xf,
  MixerPref9_BiLinearFiltering = 0x10,
  MixerPref9_PointFiltering = 0x20,
  MixerPref9_AnisotropicFiltering = 0x40,
  MixerPref9_PyramidalQuadFiltering = 0x80,
  MixerPref9_GaussianQuadFiltering = 0x100,
  MixerPref9_FilteringReserved = 0xe00,
  MixerPref9_FilteringMask = 0xff0,
  MixerPref9_RenderTargetRGB = 0x1000,
  MixerPref9_RenderTargetYUV = 0x2000,
  MixerPref9_RenderTargetReserved = 0xfc000,
  MixerPref9_RenderTargetMask = 0xff000,
  MixerPref9_DynamicSwitchToBOB = 0x100000,
  MixerPref9_DynamicDecimateBy2 = 0x200000,
  MixerPref9_DynamicReserved = 0xc00000,
  MixerPref9_DynamicMask = 0xf00000
} VMR9MixerPrefs;

Constants

MixerPref9_NoDecimation Value: 0x1 No decimation. The video will be rendered onto the surface in its native size.
MixerPref9_DecimateOutput Value: 0x2 Decimate output by 2 in the x and y directions.
MixerPref9_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. Requires Windows XP Service Pack 2. For more information, see Aspect Ratio Correction.
MixerPref9_NonSquareMixing Value: 0x8 Do not perform aspect ratio correction on the composited stream if the input video streams have the same aspect ratio. Requires Windows XP Service Pack 2. For more information, see Non-Square Mixing.
MixerPref9_DecimateMask Value: 0xf Bitmask to isolate the flags that control decimation. (This value is not a valid flag.)
MixerPref9_BiLinearFiltering Value: 0x10 Bilinear interpolation filtering. A weighted average of a 2 x 2 area of neighboring pixels is used.
MixerPref9_PointFiltering Value: 0x20 Point filtering. The value of the nearest is pixel is used.
MixerPref9_AnisotropicFiltering Value: 0x40 Anisotropic filtering.
MixerPref9_PyramidalQuadFiltering Value: 0x80 Four-sample tent filtering.
MixerPref9_GaussianQuadFiltering Value: 0x100 Four-sample Gaussian filtering.
MixerPref9_FilteringReserved Value: 0xe00 Reserved for future use.
MixerPref9_FilteringMask Value: 0xff0 Bitmask to isolate flags that control filtering. (This value is not a valid flag.)
MixerPref9_RenderTargetRGB Value: 0x1000 Use an RGB render target.
MixerPref9_RenderTargetYUV Value: 0x2000 Indicates that the target is a YUV surface. Requires Windows XP Service Pack 2. For more information, see YUV Mixing Mode.
MixerPref9_RenderTargetReserved Value: 0xfc000 Reserved for future use.
MixerPref9_RenderTargetMask Value: 0xff000 Bitmask to isolate flags that control the render target. (This value is not a valid flag.)
MixerPref9_DynamicSwitchToBOB Value: 0x100000 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 is applied when the VMR mixer composes the next video frame.
MixerPref9_DynamicDecimateBy2 Value: 0x200000 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 will be applied when the VMR mixer composes the next video frame.
MixerPref9_DynamicReserved Value: 0xc00000 Reserved.
MixerPref9_DynamicMask Value: 0xf00000 Bitmask to isolate the MixerPref9_DynamicSwitchToBOB and MixerPref9_DynamicDecimateBy2 flags. (This value is not a valid flag.)

Requirements

Requirement	Value
Header	vmr9.h

See also

DirectShow Enumerated Types

IVMRMixerControl9::GetMixingPrefs

IVMRMixerControl9::SetMixingPrefs