struttura D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Articolo
07/16/2024

La struttura D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 descrive le proprietà di un nodo di avvio di unione in un grafico di lavoro.

Sintassi

typedef struct D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 {
  D3D12DDI_NODE_ID_0108               FinalName;
  BOOL                                bProgramEntry;
  D3D12DDI_NODE_IO_KIND_0108          InputNodeIOKind;
  UINT                                InputNodeIOFlags;
  UINT                                InputRecordSizeInBytes;
  UINT                                InputMaxRecordArraySize;
  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_COALESCING_LAUNCH_NODE_PROPERTIES_0108;

Membri

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 ed è 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 in qualche modo. Questo membro è sempre TRUE per un nodo che non è destinato ad altri nodi nel grafico.

InputNodeIOKind

Enumerazione D3D12DDI_NODE_IO_KIND_0108 che specifica la classe di input. Vedere dichiarazione di input node.

InputNodeIOFlags

Flag che forniscono informazioni aggiuntive sull'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.

InputMaxRecordArraySize

Numero massimo di record di input dichiarati dallo shader che possono essere input per un avvio di un gruppo di thread per questo nodo di avvio di unione.

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 fa riferimento qui. Il runtime potrebbe avere assegnato automaticamente una posizione. Se al shader non è stata associata alcuna firma radice locale, verrà 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, tutti i nodi di origine, ma 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 viene nullptr se non sono presenti nodi destinati a 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.

Osservazioni

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 qui come selezioni finali delle proprietà. Se un driver si preoccupa se un elemento è stato sottoposto a override, può confrontare qualsiasi impostazione qui rispetto a quella dichiarata dallo shader.

Per altre informazioni, vedere Grafici di lavoro.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 11, versione 24H2 (WDDM 3.2)
intestazione	d3d12umddi.h

Vedere anche

D3D12DDI_SHADER_NODE_0108

Condividi tramite