PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS回调函数 （d3d10umddi.h）
CheckMultisampleQualityLevels 函数检索设备为指定数量的样本支持的质量级别数。
语法
PFND3D10DDI_CHECKMULTISAMPLEQUALITYLEVELS Pfnd3d10ddiCheckmultisamplequalitylevels;
void Pfnd3d10ddiCheckmultisamplequalitylevels(
D3D10DDI_HDEVICE unnamedParam1,
DXGI_FORMAT unnamedParam2,
UINT unnamedParam3,
UINT *unnamedParam4
)
{...}
参数
unnamedParam1
hDevice [in]
显示设备的句柄（图形上下文）。
unnamedParam2
格式 [in]
一个DXGI_FORMAT类型的值，指示执行检查的呈现目标格式。
unnamedParam3
SampleCount [in]
要检索其质量级别的样本数。
unnamedParam4
pNumQualityLevels [out]
指向一个变量的指针，该变量接收设备为指定数量的样本支持的质量级别。
返回值
没有
言论
驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。 如果 Format 参数中的格式不存在，或者 pNumQualityLevels 参数 NULL，驱动程序可以设置E_INVALIDARG。
如果设备不支持多个采样以及 SampleCount 参数中指定的样本数，则用户模式显示驱动程序应在 pNumQualityLevels 参数指向的变量中返回 0。
当驱动程序在 pNumQualityLevels 指向的变量中返回 1 个或多个时，驱动程序指示给定样本计数可用的特定于设备的采样变体数。 例如，如果驱动程序返回 3 个质量级别 0、1 和 2，则可以使用给定样本计数创建资源。 设备制造商定义了这些质量级别，Microsoft Direct3D 运行时无法查询。 但是，固定样本计数上的不同质量级别可能指样本位置的不同空间布局或解析的不同方法。
如果驱动程序在 SampleCount中收到 1 个，驱动程序始终返回 pNumQualityLevels 指向的变量中的 1。
如果驱动程序在 SampleCount中收到 0 或大于 32，驱动程序将始终返回 pNumQualityLevels 指向的变量中的 0。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows Vista 和更高版本的 Windows作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | d3d10umddi.h （包括 D3d10umddi.h） |