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.h
D3D11_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 |