DD_MULTISAMPLEQUALITYLEVELSDATA structure (d3dhal.h)

DirectX 9.0 and later versions only.

DD_MULTISAMPLEQUALITYLEVELSDATA is the data structure pointed to by the lpvData field of DD_GETDRIVERINFODATA for DD_GETDRIVERINFO2DATA queries with the type D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS.

Syntax

typedef struct _DD_MULTISAMPLEQUALITYLEVELSDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  D3DFORMAT             Format;
  BOOL                  bFlip : 1;
  D3DMULTISAMPLE_TYPE   MSType : 31;
  DWORD                 QualityLevels;
} DD_MULTISAMPLEQUALITYLEVELSDATA;

Members

gdi2

Specifies a DD_GETDRIVERINFO2DATA structure that contains the GetDriverInfo2 data.

Format

Uses a value from the D3DFORMAT enumeration to specify the surface format of the multiple-sampled render target.

bFlip

Indicates the type of resolution. Set to TRUE (1) for flip-style resolution and to FALSE (0) for blt-style resolution.

MSType

Uses a value from the D3DMULTISAMPLE_TYPE enumeration to specify the level of full-scene multisampling. If the display device supports maskable multisampling (more than one sample for a multiple-sample render-target format plus antialias support), the driver for the device must provide the number of quality levels for the D3DMULTISAMPLE_NONMASKABLE (1) enumerated value.

QualityLevels

Receives the number of multiple-sample quality levels that the driver supports for the given render-target format.

Remarks

The driver assigns an integer from 1 to 8 to the QualityLevels member. If the driver fails, ignores this D3DGDI2_TYPE_GETMULTISAMPLEQUALITYLEVELS query, or returns a value that is out of range, but otherwise reports that it supports multisampling, then the runtime determines that the number of quality levels is 1.

When the runtime calls a driver's DdCanCreateSurface, DdCreateSurface, or D3dCreateSurfaceEx functions to create a surface, the runtime encodes the number of multiple-sample quality levels into three bits (the DDSCAPS3_MULTISAMPLE_QUALITY_MASK mask) of the dwCaps3 member of a DDSCAPS2 structure.

For more information about D3DFORMAT and D3DMULTISAMPLE_TYPE, see the DirectX SDK documentation.

Requirements

Requirement Value
Header d3dhal.h (include D3dhal.h)

See also

D3dCreateSurfaceEx

DDSCAPS2

DD_GETDRIVERINFO2DATA

DD_GETDRIVERINFODATA

DdCanCreateSurface

DdCreateSurface