D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 structure (d3d12umddi.h)

Article
05/23/2024

La structure D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 décrit les propriétés d’un nœud de lancement de fusion dans un graphique de travail.

Syntaxe

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;

Membres

FinalName

Une structure D3D12DDI_NODE_ID_0108 qui spécifie le nom final du nœud après tous les renommages facultatifs effectués au niveau de l’application.

bProgramEntry

Lorsque la valeur est TRUE, le nœud actuel est une entrée de programme et est répertorié dans la liste pEntrypoints dans D3D12DDI_WORK_GRAPH_DESC_0108. En tant que tel, ce paramètre est redondant, mais il est présent pour plus de clarté. Le nuanceur n’a peut-être pas déclaré que le nœud est un point d’entrée, mais le runtime a peut-être déterminé qu’il doit en être un, ou au niveau de l’API, le choix a peut-être été remplacé d’une manière ou d’une autre. Ce membre a toujours la valeur TRUE pour un nœud qui n’est ciblé par aucun autre nœud dans le graphique.

InputNodeIOKind

Énumération D3D12DDI_NODE_IO_KIND_0108 qui spécifie la classe d’entrée. Consultez Déclaration d’entrée de nœud.

InputNodeIOFlags

Indicateurs qui fournissent des informations supplémentaires sur les E/S d’entrée du nœud. Consultez les indicateurs dans D3D12DDI_NODE_IO_FLAGS_FLAG_MASK dans D3D12DDI_NODE_IO_FLAGS_0108. Pour une entrée, le seul indicateur qui s’applique est D3D12DDI_NODE_IO_FLAG_TRACK_RW_INPUT_SHARING.

InputRecordSizeInBytes

Taille de l’enregistrement d’entrée, en octets. Peut être 0 si InputNodeIOKind est D3D12DDI_NODE_IO_KIND_EMPTY_INPUT_0108.

InputMaxRecordArraySize

Nombre maximal d’enregistrements d’entrée déclarés par le nuanceur qui peuvent être entrées dans un lancement d’un groupe de threads pour ce nœud de lancement de fusion.

GroupSharedUsageInBytes

Taille de l’utilisation partagée du groupe par le nœud, en octets.

MaxRecursionDepth

Récursivité maximale déclarée par le nuanceur. La valeur 0 signifie aucune récursivité.

pLocalRootArgumentsTableIndex

Si une signature racine locale a été associée au nuanceur et/ou que le nuanceur a déclaré explicitement un index de table d’arguments racine local qu’il souhaite utiliser, l’index de base 0 est pointé vers cet index. Un emplacement peut être attribué automatiquement au runtime. Si aucune signature racine locale n’a été associée au nuanceur, il s’agit nullptrde .

pShareInputOfNode

Pointeur facultatif vers un nœud qui partage la même entrée avec ce nœud, ou nullptr si le nœud actuel ne partage pas l’entrée d’un autre nœud. Si ce nœud partage son entrée à partir d’un autre nœud dans le graphe de travail, pShareInputOfNode pointe vers ce nœud, représenté par une structure D3D12DDI_NODE_0108 . Si plusieurs nœuds se trouvent dans un jeu de partage d’entrée, tous les nœuds à l’exception du nœud source pointent vers le nœud source, et le nœud source définit à la place le paramètre pNodesSharingInputWithThisNode pour qu’il pointe vers les autres.

pInputNodes

Pointeur vers une liste (D3D12DDI_NODE_LIST_ENTRY_0108) de nœuds ((D3D12DDI_NODE_0108) qui ciblent le nœud actuel. pInputNodes est nullptr si aucun nœud ne cible ce nœud.

pNodesSharingInputWithThisNode

Pointeur vers une liste (D3D12DDI_NODE_LIST_ENTRY_0108) de nœuds ((D3D12DDI_NODE_0108) qui partagent l’entrée avec le nœud actuel. pNodesSharingInputWithThisNode est nullptr si aucun nœud ne partage l’entrée avec ce nœud.

NumOutputs

Nombre de nœuds vers lesquels ce nœud est généré.

pOutputs

Pointeur vers un tableau de structures NumOutputsD3D12DDI_NODE_OUTPUT_0108 qui contiennent des définitions de sortie. pOutputs est nullptr si ce nœud ne génère pas de sortie vers d’autres nœuds.

Remarques

Toutes les propriétés répertoriées ici sont prioritaires sur (remplacer) ce qui a pu être déclaré dans le nuanceur pour le nœud. Le pilote doit toujours utiliser les propriétés répertoriées ici comme sélections de propriétés finales. Si un pilote se soucie de savoir si quelque chose a été remplacé, il peut comparer n’importe quel paramètre ici à ce que le nuanceur a déclaré.

Pour plus d’informations, consultez Graphiques de travail.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 11, version 24H2 (WDDM 3.2)
En-tête	d3d12umddi.h

Voir aussi

D3D12DDI_SHADER_NODE_0108

Partager via