Share via

VMR9SurfaceAllocationFlags 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 VMR9SurfaceAllocationFlags enumeration type is used with the IVMRSurfaceAllocator9::InitializeDevice method to specify surface creation parameters (VMR-9 only).

Syntax

typedef enum __MIDL___MIDL_itf_vmr9_0000_0001_0001 {
  VMR9AllocFlag_3DRenderTarget = 0x1,
  VMR9AllocFlag_DXVATarget = 0x2,
  VMR9AllocFlag_TextureSurface = 0x4,
  VMR9AllocFlag_OffscreenSurface = 0x8,
  VMR9AllocFlag_RGBDynamicSwitch = 0x10,
  VMR9AllocFlag_UsageReserved = 0xe0,
  VMR9AllocFlag_UsageMask = 0xff
} VMR9SurfaceAllocationFlags;

Constants

 
VMR9AllocFlag_3DRenderTarget
Value: 0x1
Indicates that the surface is a Direct3D render target.
VMR9AllocFlag_DXVATarget
Value: 0x2
Indicates that the render target supports DXVA.
VMR9AllocFlag_TextureSurface
Value: 0x4
Indicates that the target is a Direct3D texture surface.
VMR9AllocFlag_OffscreenSurface
Value: 0x8
Indicates an offscreen surface.
VMR9AllocFlag_RGBDynamicSwitch
Value: 0x10
In YUV mixing mode, indicates that the mixer can accept RGB formats in addition to the specified YUV format. The allocator-presenter can switch between the formats dynamically. This flag is only valid in YUV mixing mode.
VMR9AllocFlag_UsageReserved
Value: 0xe0
Reserved for future use.
VMR9AllocFlag_UsageMask
Value: 0xff
Bitwise OR of all flags; not used by applications

Remarks

The VMR9AllocFlag_TextureSurface flag can be combined with the VMR9AllocFlag_DXVATarget and VMR9AllocFlag_3DRenderTarget flags.

Requirements

Requirement Value
Header vmr9.h

See also

DirectShow Enumerated Types