PFND3DDDI_GETQUERYDATA回调函数 (d3dumddi.h)

GetQueryData 函数检索有关查询的信息。

语法

PFND3DDDI_GETQUERYDATA Pfnd3dddiGetquerydata;

HRESULT Pfnd3dddiGetquerydata(
  HANDLE hDevice,
  const D3DDDIARG_GETQUERYDATA *unnamedParam2
)
{...}

参数

hDevice

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

unnamedParam2

pData [in, out]

指向 D3DDDIARG_GETQUERYDATA 结构的指针,该结构包含有关从驱动程序检索的查询的信息。

返回值

GetQueryData 返回以下值之一:

返回代码 描述
S_OK 查询作已完成,查询结果可用。
S_FALSE GetQueryData 已成功返回。 但是,查询作未完成,因此查询结果不可用。
E_OUTOFMEMORY GetQueryData 无法为其分配完成所需的内存。

言论

Microsoft Direct3D 运行时可以在调用用户模式显示驱动程序的 IssueQuery 函数后随时调用 GetQueryData。 用户模式显示驱动程序应根据存储在驱动程序的专用查询结构中的值检查当前围栏值,以确定查询问题是否已完成。

如果查询已完成,驱动程序应返回S_OK;否则,驱动程序应返回S_FALSE。

如果驱动程序支持 运行时处理的多处理器优化 并公开0x0000000B或更高版本的 DDI 版本,则运行时将以重新进入的方式调用 GetQueryData。 驱动程序在调用驱动程序的 OpenAdapter 函数时,返回 DriverVersionD3D10DDIARG_OPENADAPTER 结构成员中的 DDI 版本值。 当运行时以重新进入的方式调用 GetQueryData 时,一个线程可以在 GetQueryData 内执行,另一个引用同一显示设备的线程在另一个用户模式显示驱动程序函数中执行。

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的 Windows作系统中可用。
目标平台 桌面
标头 d3dumddi.h (包括 D3dumddi.h)

另请参阅

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery