struttura D3D12DDI_THREAD_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Articolo
05/23/2024

La struttura D3D12DDI_THREAD_LAUNCH_NODE_PROPERTIES_0108 descrive le proprietà di un nodo di avvio del thread.

Sintassi

typedef struct D3D12DDI_THREAD_LAUNCH_NODE_PROPERTIES_0108 {
  D3D12DDI_NODE_ID_0108               FinalName;
  BOOL                                bProgramEntry;
  D3D12DDI_NODE_IO_KIND_0108          InputNodeIOKind;
  UINT                                InputNodeIOFlags;
  UINT                                InputRecordSizeInBytes;
  UINT                                GroupSharedUsageInBytes;
  UINT                                MaxRecursionDepth;
  const UINT                          *pLocalRootArgumentsTableIndex;
  const D3D12DDI_NODE_0108            *pShareInputOfNode;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pInputNodes;
  const D3D12DDI_NODE_LIST_ENTRY_0108 *pNodesSharingInputWithThisNode;
  UINT                                NumOutputs;
  const D3D12DDI_NODE_OUTPUT_0108     *pOutputs;
} D3D12DDI_THREAD_LAUNCH_NODE_PROPERTIES_0108;

Members

FinalName

Struttura D3D12DDI_NODE_ID_0108 che specifica il nome finale del nodo dopo qualsiasi ridenominazione facoltativa eseguita a livello di applicazione.

bProgramEntry

Se TRUE, il nodo corrente è una voce di programma e viene elencato nell'elenco pEntrypoints in D3D12DDI_WORK_GRAPH_DESC_0108. Di conseguenza, questo parametro è ridondante, ma è presente per maggiore chiarezza. Lo shader potrebbe non aver dichiarato che il nodo è un punto di ingresso, ma il runtime potrebbe aver determinato che deve essere uno o nell'API la scelta potrebbe essere stata sottoposta a override. Questo membro è sempre TRUE per un nodo che non è destinato ad altri nodi del grafico.

InputNodeIOKind

Enumerazione D3D12DDI_NODE_IO_KIND_0108 che specifica la classe di input. Vedere Dichiarazione di input del nodo.

InputNodeIOFlags

Flag che forniscono informazioni aggiuntive sulle operazioni di I/O di input del nodo. Vedere i flag all'interno di D3D12DDI_NODE_IO_FLAGS_FLAG_MASK in D3D12DDI_NODE_IO_FLAGS_0108. Per un input, l'unico flag applicabile è D3D12DDI_NODE_IO_FLAG_TRACK_RW_INPUT_SHARING.

InputRecordSizeInBytes

Dimensioni del record di input, in byte. Può essere 0 se InputNodeIOKind è D3D12DDI_NODE_IO_KIND_EMPTY_INPUT_0108.

GroupSharedUsageInBytes

Dimensioni dell'utilizzo condiviso del gruppo in byte dal nodo.

MaxRecursionDepth

Ricorsione massima dichiarata dallo shader. Il valore 0 indica che non viene eseguita alcuna ricorsione.

pLocalRootArgumentsTableIndex

Se una firma radice locale è stata associata allo shader e/o allo shader ha dichiarato in modo esplicito un indice di tabella dell'argomento radice locale che vuole usare, l'indice basato su 0 viene indicato qui. Il runtime può avere assegnato automaticamente un percorso. Se al shader non è stata associata alcuna firma radice locale, sarà nullptr.

pShareInputOfNode

Puntatore facoltativo a un nodo che condivide lo stesso input con questo nodo o nullptr se il nodo corrente non condivide l'input di un altro nodo. Se questo nodo condivide l'input da un altro nodo nel grafico di lavoro, pShareInputOfNode punta a tale nodo, rappresentato da una struttura D3D12DDI_NODE_0108 . Se più nodi si trovano in un set di condivisione di input, tutto tranne il nodo di origine punta al nodo di origine e il nodo di origine imposta invece il parametro pNodesSharingInputWithThisNode in modo che punti agli altri.

pInputNodes

Puntatore a un elenco (D3D12DDI_NODE_LIST_ENTRY_0108) di nodi ((D3D12DDI_NODE_0108) destinati al nodo corrente. pInputNodes è se nessun nodo ha nullptr come destinazione questo nodo.

pNodesSharingInputWithThisNode

Puntatore a un elenco (D3D12DDI_NODE_LIST_ENTRY_0108) di nodi ((D3D12DDI_NODE_0108) che condividono l'input con il nodo corrente. pNodesSharingInputWithThisNode è nullptr se nessun nodo condivide l'input con questo nodo.

NumOutputs

Numero di nodi a cui viene restituito questo nodo.

pOutputs

Puntatore a una matrice di NumOutputsD3D12DDI_NODE_OUTPUT_0108 strutture che contengono definizioni di output. pOutputs è nullptr se questo nodo non restituisce altri nodi.

Commenti

Tutte le proprietà elencate di seguito hanno la precedenza su (override) su ciò che potrebbe essere stato dichiarato nello shader per il nodo. Il driver deve usare sempre le proprietà elencate di seguito come selezioni finali delle proprietà. Se un driver interessa se è stato sottoposto a override, può confrontare qualsiasi impostazione qui rispetto a quella dichiarata dallo shader.

Per altre informazioni, vedere Grafici di lavoro.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 11 versione 24H2 (WDDM 3.2)
Intestazione	d3d12umddi.h

Vedi anche

D3D12DDI_SHADER_NODE_0108

Condividi tramite