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)

另请参阅

D3D10DDI_DEVICEFUNCS

pfnSetErrorCb