PFND3D12DDI_BEGIN_END_QUERY Rückruffunktion (d3d12umddi.h)

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

Syntax

PFND3D12DDI_BEGIN_END_QUERY Pfnd3d12ddiBeginEndQuery;

void Pfnd3d12ddiBeginEndQuery(
  D3D12DDI_HCOMMANDLIST unnamedParam1,
  D3D12DDI_HQUERYHEAP unnamedParam2,
  UINT unnamedParam3,
  D3D12DDI_QUERY_TYPE 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

StartElement-

Der Wert des Startelements.

unnamedParam4

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.

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
mindestens unterstützte Client-	Windows 10
Header-	d3d12umddi.h (include d3d12umddi.h)