PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS callback function (d3d10umddi.h)

The CheckMultisampleQualityLevels function retrieves the number of quality levels that the device supports for the specified number of samples.

Syntax

PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;

void Pfnd3d10ddiCheckmultisamplequalitylevels(
  D3D10DDI_HDEVICE unnamedParam1,
  DXGI_FORMAT unnamedParam2,
  UINT unnamedParam3,
  UINT *unnamedParam4
)
{...}

Parameters

unnamedParam1

hDevice [in]

A handle to the display device (graphics context).

unnamedParam2

Format [in]

A DXGI_FORMAT-typed value that indicates the render-target format that the check is performed for.

unnamedParam3

SampleCount [in]

The number of samples to retrieve the quality levels for.

unnamedParam4

pNumQualityLevels [out]

A pointer to a variable that receives the number of quality levels that the device supports for the specified number of samples.

Return value

None

Remarks

The driver can use the pfnSetErrorCb callback function to set an error code. The driver can set E_INVALIDARG if the format in the Format parameter does not exist or the pNumQualityLevels parameter is NULL.

If the device does not support multiple sampling with the number of samples that is specified in the SampleCount parameter, the user-mode display driver should return 0 in the variable that the pNumQualityLevels parameter points to.

When the driver returns 1 or more in the variable that pNumQualityLevels points to, the driver indicates the number of device-specific sampling variations that are available with the given sample count. For example, if the driver returns 3, quality levels 0, 1, and 2 can be used to create resources with the given sample count. The device manufacturer defines these quality levels, which the Microsoft Direct3D runtime cannot query. However, different quality levels at a fixed sample count might refer to different spatial layouts of the sample locations or different methods of resolving.

If the driver receives 1 in SampleCount, the driver always returns 1 in the variable that pNumQualityLevels points to.

If the driver receives 0 or greater than 32 in SampleCount, the driver always returns 0 in the variable that pNumQualityLevels points to.

Requirements

See also

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb