ID3D11Device::CheckMultisampleQualityLevels 方法 (d3d11.h)

获取多重采样期间可用的质量级别数。

语法

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

参数

[in] Format

类型: DXGI_FORMAT

纹理格式。 请参阅 DXGI_FORMAT

[in] SampleCount

类型: UINT

多重采样期间的样本数。

[out] pNumQualityLevels

类型: UINT*

适配器支持的质量级别数。 请参阅备注

返回值

类型: HRESULT

此方法返回以下 Direct3D 11 返回代码之一。

注解

对纹理进行多重采样时,适配器可用的质量级别数取决于所使用的纹理格式和请求的样本数。 最大质量级别数由 中的D3D11.hD3D11_MAX_MULTISAMPLE_SAMPLE_COUNT定义。 如果此方法 (S_OK) 返回 0,并且输出参数 pNumQualityLevels 收到正值,则设备支持格式和样本计数组合。 当组合不受支持时,此方法返回失败 的 HRESULT 代码 (即负整数) ,或将输出参数设置为 pNumQualityLevels 零或两者。

此外,质量级别的定义留给每个硬件供应商进行定义:但是,Direct3D 不提供任何帮助发现此信息的设施。

请注意,对于除R32G32B32A32和R32G32B32以外的所有呈现目标,需要FEATURE_LEVEL_10_1设备支持 4x MSAA。 FEATURE_LEVEL_11_0设备需要为所有呈现目标格式支持 4x MSAA,对于除R32G32B32A32格式以外的所有呈现目标格式,支持 8x MSAA。

要求

要求
目标平台 Windows
标头 d3d11.h
Library D3D11.lib

另请参阅

ID3D11Device