PFND3D12DDI_BEGIN_END_QUERY_0003 Rückruffunktion (d3d12umddi.h)

Die PfnBeginQuery-Rückruffunktion definiert den Anfang des Teils einer Befehlsliste, für den eine Abfrage gilt.

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 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 für Anwendungen undurchsichtig. Abfrageergebnisse werden in einem Abfrageheap gespeichert, bis sie später in das von der API definierte Format "aufgelöst" werden.

unnamedParam3

QueryType

Der Abfragetyp. Resolve wird von Anwendungen verwendet, um ein Zuvor in einem Abfrageheap gespeichertes Abfrageergebnis 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.

unnamedParam4

StartElement

Der Wert des Startelements.

Rückgabewert

Keine

Bemerkungen

Start/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 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 nur EndQuery für diesen Abfragetyp verwendet.

Anforderungen