ID3D10Device::CheckMultisampleQualityLevels method (d3d10.h)

Get the number of quality levels available during multisampling.

Syntax

HRESULT CheckMultisampleQualityLevels(
  [in]  DXGI_FORMAT Format,
  [in]  UINT        SampleCount,
  [out] UINT        *pNumQualityLevels
);

Parameters

[in] Format

Type: DXGI_FORMAT

The texture format. See DXGI_FORMAT.

[in] SampleCount

Type: UINT

The number of samples during multisampling.

[out] pNumQualityLevels

Type: UINT*

Number of quality levels supported by the adapter. See remarks.

Return value

Type: HRESULT

This method returns one of the following Direct3D 10 Return Codes.

Remarks

When multisampling a texture, the number of quality levels available for an adapter is dependent on the texture format used and the number of samples requested. The maximum sample count defined by D3D10_MAX_MULTISAMPLE_SAMPLE_COUNT in d3d10.h is 32. If the returned value of pNumQualityLevels is 0, the format and sample count combination is not supported for the installed adapter.

Furthermore, the definition of a quality level is up to each hardware vendor to define, however no facility is provided by Direct3D to help discover this information.

Direct3D 10.1 devices are required to support 4x MSAA for all formats except R32G32B32A32 and R32G32B32 formats.

Requirements

Requirement Value
Target Platform Windows
Header d3d10.h
Library D3D10.lib

See also

ID3D10Device Interface