estrutura D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Artigo
07/16/2024

A estrutura D3D12DDI_COALESCING_LAUNCH_NODE_PROPERTIES_0108 descreve as propriedades de um nó de inicialização de associação em um grafo de trabalho.

Sintaxe

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;

Membros

FinalName

Uma estrutura D3D12DDI_NODE_ID_0108 que especifica o nome final do nó após qualquer renomeação opcional feita no nível do aplicativo.

bProgramEntry

Quando TRUE, o nó atual é uma entrada de programa e está listado na lista pEntrypoints no D3D12DDI_WORK_GRAPH_DESC_0108. Como tal, esse parâmetro é redundante, mas está presente para maior clareza. O sombreador pode não ter declarado que o nó é um ponto de entrada, mas o runtime pode ter determinado que deve ser um ou, na API, a escolha pode ter sido substituída de alguma forma. Esse membro é sempre TRUE para um nó que não é direcionado por nenhum outro nó no grafo.

InputNodeIOKind

Uma enumeração D3D12DDI_NODE_IO_KIND_0108 que especifica a classe de entrada. Consulte declaração de entrada do nó.

InputNodeIOFlags

Sinalizadores que fornecem informações adicionais sobre a E/S de entrada do nó. Consulte os sinalizadores dentro de D3D12DDI_NODE_IO_FLAGS_FLAG_MASK em D3D12DDI_NODE_IO_FLAGS_0108. Para uma entrada, o único sinalizador que se aplica é D3D12DDI_NODE_IO_FLAG_TRACK_RW_INPUT_SHARING.

InputRecordSizeInBytes

Tamanho do registro de entrada, em bytes. Pode ser 0 se InputNodeIOKind estiver D3D12DDI_NODE_IO_KIND_EMPTY_INPUT_0108.

InputMaxRecordArraySize

Número máximo de registros de entrada que o sombreador declarou que podem ser inseridos em uma inicialização de um grupo de threads para esse nó de inicialização de coalescing.

GroupSharedUsageInBytes

Tamanho do uso compartilhado do grupo pelo nó, em bytes.

MaxRecursionDepth

Recursão máxima declarada por sombreador. Um valor de 0 significa nenhuma recursão.

pLocalRootArgumentsTableIndex

Se uma assinatura raiz local tiver sido associada ao sombreador e/ou ao sombreador declarado explicitamente um índice de tabela de argumentos raiz local que deseja usar, o índice baseado em 0 será apontado aqui. O runtime pode ter atribuído automaticamente um local. Se nenhuma assinatura raiz local tiver sido associada ao sombreador, isso será nullptr.

pShareInputOfNode

Ponteiro opcional para um nó que compartilha a mesma entrada com esse nó ou nullptr se o nó atual não estiver compartilhando a entrada de outro nó. Se esse nó estiver compartilhando sua entrada de outro nó no grafo de trabalho, pShareInputOfNode apontará para esse nó, representado por uma estrutura de D3D12DDI_NODE_0108. Se vários nós estiverem em um conjunto de compartilhamento de entrada, todos, exceto o nó de origem, apontam para o nó de origem e, em vez disso, o nó de origem define o parâmetro pNodesSharingInputWithThisNode para apontar para os outros.

pInputNodes

Ponteiro para uma lista (D3D12DDI_NODE_LIST_ENTRY_0108) de nós ((D3D12DDI_NODE_0108) que direcionam o nó atual. pInputNodes será nullptr se nenhum nó atingir esse nó.

pNodesSharingInputWithThisNode

Ponteiro para uma lista (D3D12DDI_NODE_LIST_ENTRY_0108) de nós ((D3D12DDI_NODE_0108) que compartilham a entrada com o nó atual. pNodesSharingInputWithThisNode será nullptr se nenhum nó compartilhar a entrada com esse nó.

NumOutputs

Número de nós para os quais esse nó é gerado.

pOutputs

Ponteiro para uma matriz de numOutputsD3D12DDI_NODE_OUTPUT_0108 estruturas que contêm definições de saída. de pOutputs será nullptr se esse nó não for gerado para outros nós.

Observações

Todas as propriedades listadas aqui têm precedência sobre (substituição) o que pode ter sido declarado no sombreador para o nó. O driver sempre deve usar as propriedades listadas aqui como as seleções de propriedade final. Se um driver se importar se algo foi substituído, ele poderá comparar qualquer configuração aqui com o que o sombreador declarou.

Para obter mais informações, consulte Gráficos de trabalho.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 11, versão 24H2 (WDDM 3.2)
cabeçalho	d3d12umddi.h

Consulte também

D3D12DDI_SHADER_NODE_0108

Compartilhar via