VMR9AllocationInfo structure (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 VMR9AllocationInfo structure describes the Direct3D surfaces that a VMR-9 Allocator-Presenter object should allocate.

Syntax

typedef struct _VMR9AllocationInfo {
  DWORD     dwFlags;
  DWORD     dwWidth;
  DWORD     dwHeight;
  D3DFORMAT Format;
  D3DPOOL   Pool;
  DWORD     MinBuffers;
  SIZE      szAspectRatio;
  SIZE      szNativeSize;
} VMR9AllocationInfo;

Members

dwFlags

Specifies a bitwise combination of flags from the VMR9SurfaceAllocationFlags enumeration type.

dwWidth

Specifies the width of the surfaces.

dwHeight

Specifies the height of the surfaces.

Format

Specifies the surface format, as a D3DFORMAT type. The value D3DFMT_UNKNOWN (zero) indicates that the surface format should be compatible with the display.

Pool

Specifies the Direct3D memory pool to use for the surfaces, as a D3DPOOL type.

MinBuffers

Specifies the minimum number of buffers to create.

szAspectRatio

Specifies the video aspect ratio as a SIZE structure.

szNativeSize

Specifies the native video size as a SIZE structure.

Requirements

Requirement Value
Header vmr9.h

See also

DirectShow Structures

IVMRSurfaceAllocator9::InitializeDevice

IVMRSurfaceAllocatorNotify9::AllocateSurfaceHelper