D3DHAL_DP2CREATEQUERY Struktur (d3dhal.h)

Artikel
02/06/2025

Nur DirectX 9.0 und höhere Versionen.

Mindestens eine D3DHAL_DP2CREATEQUERY Strukturen werden vom Befehlspuffer vom D3dDrawPrimitives2 Rückruf analysiert, wenn das bCommand Member der D3DHAL_DP2COMMAND Struktur auf D3DDP2OP_CREATEQUERY festgelegt ist und zum Erstellen von Ressourcen für Abfragen verwendet wird.

Syntax

typedef struct _D3DHAL_DP2CREATEQUERY {
  DWORD        dwQueryID;
  D3DQUERYTYPE QueryType;
} D3DHAL_DP2CREATEQUERY;

Angehörige

dwQueryID

Identifiziert die Abfrage.

QueryType

Gibt einen Wert aus der D3DQUERYTYPE -Aufzählung an, die die Abfragefunktion angibt, für die der Treiber Ressourcen erstellt.

Bemerkungen

Die Laufzeit verwendet D3DHAL_DP2CREATEQUERY, um jede Abfrage mit einem eindeutigen Bezeichner und einem Abfragetyp zu identifizieren. Der D3dDrawPrimitives2 Rückruf des Treibers muss wPrimitiveCount D3DHAL_DP2CREATEQUERY Strukturen aus dem Befehlspuffer verarbeiten. Der Wert wPrimitiveCount wird in der D3DHAL_DP2COMMAND-Struktur angegeben. Der Treiber analysiert diese Strukturen und erstellt Ressourcen für die Abfragen, die sie nach Bedarf darstellen.

Der Treiber erstellt Ressourcen für die folgenden Abfragetypen:

BOOL für D3DQUERYTYPE_EVENT. Bevor Sie mit D3DDP2OP_RESPONSEQUERY für ein Ereignis reagieren, muss der Treiber sicherstellen, dass die Grafikverarbeitungseinheit (GPU) alle D3DHAL_DP2OPERATION Vorgänge verarbeitet, die mit dem Ereignis zusammenhängen. Das heißt, der Treiber antwortet nur, nachdem der ISSUE_END Zustand des Ereignisses auftritt. Der Treiber muss beim Reagieren immer den BOOL-Wert des Ereignisses auf TRUE- festlegen.
DWORD für D3DQUERYTYPE_OCCLUSION. Der Treiber legt dieses DWORD auf die Anzahl der Pixel fest, für die der Z-Test für alle Grundtypen zwischen Dem Anfang und Ende der Abfrage bestanden hat. Wenn der Tiefenpuffer multisampelt ist, bestimmt der Treiber die Anzahl der Pixel aus der Anzahl der Beispiele. Wenn das Anzeigegerät jedoch in der Lage ist, die Genauigkeit des Multisample-Z-Tests zu überprüfen, sollte die Konvertierung in die Anzahl der Pixel im Allgemeinen aufgerundet werden. Eine Anwendung kann dann das Okklusionsergebnis gegen 0 überprüfen, um effektiv "vollständig verdeckt" zu bedeuten. Treiber, die Multisampling-Mengen in Pixelmengen konvertieren, sollten Renderziel-Multisampling-Änderungen erkennen und die Abfrageergebnisse entsprechend berechnen.
D3DDEVINFO_VCACHE Struktur für D3DQUERYTYPE_VCACHE.