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 函数时,返回 D3D10DDIARG_OPENADAPTER 结构的 DriverVersion 成员中的 DDI 版本值。 当运行时以可重入方式调用 GetQueryData 时,一个线程可以在 GetQueryData 中执行,而另一个引用相同显示设备的线程可以在另一个用户模式显示驱动程序函数内执行。

要求

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

另请参阅

D3DDDIARG_GETQUERYDATA

D3DDDI_DEVICEFUNCS

IssueQuery