PFND3D12DDI_BEGIN_END_QUERY_0003 funzione di callback (d3d12umddi.h)

Articolo
02/06/2025

La pfnBeginQuery funzione di callback definisce l'inizio della parte di un elenco di comandi a cui viene applicata una query.

Sintassi

PFND3D12DDI_BEGIN_END_QUERY_0003 Pfnd3d12ddiBeginEndQuery0003;

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

Parametri

unnamedParam1

hCommandList

Handle per i dati del driver per l'elenco di comandi. Il driver usa questa area di memoria per archiviare strutture di dati interne correlate all'elenco di comandi.

unnamedParam2

hQueryHeap

Handle di un heap di query, che rappresenta una matrice di risultati della query. La rappresentazione dei dati sottostante di un risultato della query dipende dall'heap delle query e dalle applicazioni opache. I risultati delle query vengono archiviati in un heap di query fino a quando non vengono successivamente "risolti" nel formato definito dall'API.

unnamedParam3

QueryType

Tipo di query. Resolve viene usato dalle applicazioni per trasformare un risultato di query archiviato in precedenza in un heap di query nel formato definito dall'API. I dati risolti vengono archiviati in un buffer D3D12. I risultati possono quindi essere utilizzati da uno shader, da un predicato o mappato e letti sulla CPU.

unnamedParam4

StartElement

Valore dell'elemento iniziale.

Valore restituito

Nessuno

Osservazioni

La query di inizio/fine e la query di risoluzione sono comandi pianificati elaborati nella GPU. Non esiste alcun punto di ingresso definito per consentire l'elaborazione della CPU nei risultati della query.

È possibile definire query che non si applicano a più comandi per usare solo EndQuery. Ad esempio, se la query D3D12DDI_QUERY_TYPE_VIDEO_DECODE_STATISTICS si applica solo al comando DecodeFrame precedente nello stesso elenco di comandi, solo EndQuery viene usato per questo tipo di query.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Finestre
intestazione	d3d12umddi.h (include D3d12umddi.h)

Condividi tramite