VMR9MixerPrefs enumeration (vmr9.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 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

   
Header vmr9.h

See also

DirectShow Enumerated Types

IVMRMixerControl9::GetMixingPrefs

IVMRMixerControl9::SetMixingPrefs