PFND3D12DDI_BEGIN_END_QUERY_0003 Rückruffunktion (d3d12umddi.h)

Die pfnBeginQuery Rückruffunktion definiert den Anfang des Teils einer Befehlsliste, auf den eine Abfrage angewendet wird.

Syntax

PFND3D12DDI_BEGIN_END_QUERY_0003 Pfnd3d12ddiBeginEndQuery0003;

void Pfnd3d12ddiBeginEndQuery0003(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HQUERYHEAP unnamedParam2,
  D3D12DDI_QUERY_TYPE unnamedParam3,
  UINT unnamedParam4
)
{...}

Parameter

unnamedParam1

hCommandList-

Ein Handle für die Treiberdaten für die Befehlsliste. Der Treiber verwendet diesen Speicherbereich, um interne Datenstrukturen zu speichern, die mit der Befehlsliste zusammenhängen.

unnamedParam2

hQueryHeap-

Das Handle eines Abfragehaps, das ein Array von Abfrageergebnissen darstellt. Die zugrunde liegende Datendarstellung eines Abfrageergebnisses ist in Abfrage heaps und undurchsichtig für Anwendungen abhängig. Abfrageergebnisse werden in einem Abfragehap gespeichert, bis sie später in das api definierte Format "aufgelöst" werden.

unnamedParam3

QueryType-

Der Abfragetyp. Resolve wird von Anwendungen verwendet, um ein abfrageergebnis zu transformieren, das zuvor in einem Abfragehap in das api definierte Format gespeichert wurde. Die aufgelösten Daten werden in einem D3D12-Puffer gespeichert. Die Ergebnisse können dann von einem Shader, einer Prädication oder einem zugeordneten und gelesenen CPU-Element genutzt werden.

unnamedParam4

StartElement-

Der Wert des Startelements.

Rückgabewert

Nichts

Bemerkungen

Begin/End-Abfrage und Auflösungsabfrage sind geplante Befehle, die auf der GPU verarbeitet werden. Es gibt keinen definierten Einstiegspunkt, um die CPU-Verarbeitung für die Abfrageergebnisse zuzulassen.

Abfragen, die nicht auf mehrere Befehle angewendet werden, können nur für die Verwendung von EndQuery definiert werden. Wenn die D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS Abfrage beispielsweise nur für den vorherigen DecodeFrame-Befehl in derselben Befehlsliste gilt, wird nur EndQuery für diesen Abfragetyp verwendet.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	d3d12umddi.h (einschließlich D3d12umddi.h)