DD_GETD3DQUERYDATA Struktur (d3dhal.h)

Artikel
02/23/2024

Nur DirectX 9.0 und höhere Versionen.

DD_GETD3DQUERYDATA ist die Datenstruktur, auf die das Feld lpvData von 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;

Member

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-Enumeration, der die tatsächliche Abfragefunktion angibt.

Hinweise

Die Runtime identifiziert den zurückzugebenden Abfragetyp mit einem ganzzahligen Index, dessen Wert zwischen null und eins kleiner als die Anzahl der unterstützten Abfragetypen variiert, 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.

Beim Verarbeiten dieser GetDriverInfo2-Anforderung sollte der Treiber den Wert in der Union so lesen, als ob es sich um den dwQueryIndex-Member handelt, und diesen Wert einem der unterstützten Abfragetypen zuordnen (wahrscheinlich durch Verwendung des Werts in dwQueryIndex als Index in einem Array mit D3DQUERYTYPE Werten). Der Treiber sollte diesen Abfragetyp dann so in die Union kopieren, als wäre er das QueryType-Element . Die Laufzeit garantiert, dass nur ein Index an den Treiber übergeben wird, der sich im Bereich von null bis eins unter der Anzahl der vom Treiber gemeldeten Abfragetypen befindet. Der Bereich des Indexes sollte im Build des Debugtreibers überprüft werden.

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