// d3dhal.h
typedef struct _DD_MULTISAMPLEQUALITYLEVELSDATA {
DD_GETDRIVERINFO2DATA gdi2;
D3DFORMAT Format;
BOOL bFlip : 1;
D3DMULTISAMPLE_TYPE MSType : 31;
DWORD QualityLevels;
} DD_MULTISAMPLEQUALITYLEVELSDATA;
View the official Windows Driver Kit DDI referenceNo description available.
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.
gdi2Specifies a DD_GETDRIVERINFO2DATA structure that contains the GetDriverInfo2 data.
FormatUses a value from the D3DFORMAT enumeration to specify the surface format of the multiple-sampled render target.
bFlipIndicates the type of resolution. Set to TRUE (1) for flip-style resolution and to FALSE (0) for blt-style resolution.
MSTypeUses 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.
QualityLevelsReceives the number of multiple-sample quality levels that the driver supports for the given render-target format.
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.