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 diese Speicherregion, um interne Datenstrukturen zu speichern, die sich auf die Befehlsliste beziehen.

unnamedParam2

hQueryHeap

Das Handle eines Abfrageheaps, das ein Array von Abfrageergebnissen darstellt. Die zugrunde liegende Datendarstellung eines Abfrageergebnisses ist IHV-abhängig in Abfrageheaps und nicht transparent für Anwendungen. Abfrageergebnisse werden in einem Abfrageheap gespeichert, bis sie später in das von der API definierte Format "aufgelöst" werden.

unnamedParam3

StartElement

Der Wert des start-Elements.

unnamedParam4

QueryType

Der Abfragetyp. Auflösen wird von Anwendungen verwendet, um ein Abfrageergebnis, das zuvor in einem Abfrageheap gespeichert wurde, in das von der API definierte Format zu transformieren. Die aufgelösten Daten werden in einem D3D12-Puffer gespeichert. Die Ergebnisse können dann von einem Shader, einer Prädication oder zugeordnet und auf der CPU gelesen werden.

Rückgabewert

Keine

Bemerkungen

Start/End-Abfragen und Auflösen von Abfragen sind geplante Befehle, die auf der GPU verarbeitet werden. Es gibt keinen definierten Einstiegspunkt, um die CPU-Verarbeitung der Abfrageergebnisse zuzulassen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10
Kopfzeile	d3d12umddi.h (include d3d12umddi.h)