PFND3DDDI_CHECKCOUNTERINFO回调函数 (d3dumddi.h)

  • 项目

由 Microsoft Direct3D 运行时调用，以确定与操作计数器相关的全局信息。 必须由 Windows 显示驱动程序模型 (WDDM) 1.3 及更高版本的用户模式显示驱动程序实现。

语法

PFND3DDDI_CHECKCOUNTERINFO Pfnd3dddiCheckcounterinfo;

void Pfnd3dddiCheckcounterinfo(
  HANDLE hDevice,
  D3DDDIARG_COUNTER_INFO *unnamedParam2
)
{...}

参数

hDevice

显示设备的句柄 (图形上下文) 。

unnamedParam2

pCounterInfo [out]

指向 D3DDDIARG_COUNTER_INFO 结构的指针，驱动程序使用与操作计数器相关的全局信息填充该结构。

返回值

无

备注

驱动程序可以使用 pfnSetErrorCb 回调函数来设置错误代码。 有关设置错误代码的详细信息，请参阅以下“备注”部分。

此函数的行为应类似于支持 Microsoft Direct3D 10 及更高版本的 CheckCounterInfo 函数。

如果用户模式显示驱动程序不支持 在 D3DDDIARG_COUNTER_INFO 结构的成员中表示的任何概念，则可以使用零填充 D3DDDIARG_COUNTER_INFO 的成员。

驱动程序的 pfnCheckCounterInfo 函数无法调用 pfnSetErrorCb 回调函数来设置D3DDDIERR_DEVICEREMOVED错误代码，因为 pfnCheckCounterInfo 是一种功能检查类型的函数。 即使存在D3DDDIERR_DEVICEREMOVED，驱动程序也必须确保在创建设备后有足够的信息来响应对 pfnCheckCounterInfo 的调用。 pfnCheckCounterInfo 不应遇到任何错误。 但是， pfnCheckCounterInfo 可能会针对严重错误调用 pfnSetErrorCb 。

要求

要求 值
最低受支持的客户端 Windows 8.1
最低受支持的服务器 Windows Server 2012 R2
目标平台 桌面
标头 d3dumddi.h (包括 D3d10umddi.h)

另请参阅

CheckCounterInfo

D3DDDIARG_COUNTER_INFO

pfnSetErrorCb