DD_GETD3DQUERYDATA 结构 (d3dhal.h)

项目
02/26/2024

仅限 DirectX 9.0 及更高版本。

DD_GETD3DQUERYDATA是DD_GETDRIVERINFODATA的 lpvData 字段指向的数据结构，用于类型为 D3DGDI2_TYPE_GETD3DQUERY 的DD_GETDRIVERINFO2DATA查询。

语法

typedef struct _DD_GETD3DQUERYDATA {
  DD_GETDRIVERINFO2DATA gdi2;
  union {
    DWORD        dwQueryIndex;
    D3DQUERYTYPE QueryType;
  };
} DD_GETD3DQUERYDATA;

成员

gdi2

指定包含 GetDriverInfo2 数据的DD_GETDRIVERINFO2DATA结构。

dwQueryIndex

指定要返回的查询类型的索引。

QueryType

从指定实际查询功能的 D3DQUERYTYPE 枚举接收值。

注解

运行时使用整数索引标识要返回的查询类型，该索引的值在零到 1 之间变化，比驱动程序先前在D3DGDI2_TYPE_GETD3DQUERYCOUNT查询中报告的受支持查询类型的数量少一个。这些索引如何映射到实际查询类型由驱动程序决定。但是，每个索引必须唯一映射到一个受支持的查询类型。报告查询类型的顺序并不重要。

处理此 GetDriverInfo2 请求时，驱动程序应读取联合中的值，就像它是 dwQueryIndex 成员一样，并将该值映射到受支持的查询类型之一， (可能通过使用 dwQueryIndex 中的值作为索引进入) D3DQUERYTYPE值数组。然后，驱动程序应将该查询类型复制到联合中，就像它是 QueryType 成员一样。运行时保证只向驱动程序传递索引，该索引的范围比驱动程序报告的查询类型数少 0 到 1。应在调试驱动程序生成中验证索引的范围。

有关D3DQUERYTYPE的详细信息，请参阅 DirectX SDK 文档。