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