DD_GETD3DQUERYDATA Struktur (d3dhal.h)

Artikel
02/06/2025

Nur DirectX 9.0 und höhere Versionen.

DD_GETD3DQUERYDATA ist die Datenstruktur, auf die das lpvData- Feld DD_GETDRIVERINFODATA für DD_GETDRIVERINFO2DATA Abfragen mit dem Typ D3DGDI2_TYPE_GETD3DQUERY verweist.

Syntax

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

Angehörige

gdi2

Gibt eine DD_GETDRIVERINFO2DATA Struktur an, die die GetDriverInfo2--Daten enthält.

dwQueryIndex

Gibt den Index des zurückzugebenden Abfragetyps an.

QueryType

Empfängt einen Wert aus der D3DQUERYTYPE-Aufzählung, die die tatsächliche Abfragefunktion angibt.

Bemerkungen

Die Laufzeit identifiziert den Abfragetyp, der mit einem ganzzahligen Index zurückgegeben werden soll, dessen Wert zwischen Null und 1 kleiner ist als die Anzahl der unterstützten Abfragetypen, die zuvor vom Treiber in einer D3DGDI2_TYPE_GETD3DQUERYCOUNT Abfrage gemeldet wurden. Wie diese Indizes tatsächlichen Abfragetypen zugeordnet werden, bleibt dem Treiber überlassen. Jeder Index muss jedoch einem unterstützten Abfragetyp eindeutig zugeordnet werden. Die Reihenfolge, in der die Abfragetypen gemeldet werden, ist nicht signifikant.

Bei der Verarbeitung dieses GetDriverInfo2 anfordern, sollte der Treiber den Wert in der Union so lesen, als wäre es der dwQueryIndex Member und ordnen diesen Wert einem der unterstützten Abfragetypen zu (wahrscheinlich mithilfe des Werts in dwQueryIndex als Index in einem Array von D3DQUERYTYPE Werten). Der Treiber sollte dann diesen Abfragetyp in die Union kopieren, als wäre es der QueryType Member. Die Laufzeit garantiert, dass er nur einen Index an den Treiber übergibt, der sich im Bereich 0 bis 1 unter der Anzahl der vom Treiber gemeldeten Abfragetypen befindet. Der Indexbereich sollte im Debugtreiberbuild überprüft werden.

Weitere Informationen zu D3DQUERYTYPE finden Sie in der DirectX SDK-Dokumentation.