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
D3DWDDM1_3DDI_CHECK_MULTISAMPLE_QUALITY_LEVELS_FLAG值的组合，这些值通过使用按位 OR 运算进行组合。
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) |