estrutura D3D12DDI_BROADCASTING_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Artigo
07/16/2024

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

Sintaxe

typedef struct D3D12DDI_BROADCASTING_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 UINT                               *pDispatchGrid;
  const UINT                               *pMaxDispatchGrid;
  const D3D12DDI_RECORD_DISPATCH_GRID_0108 *pRecordDispatchGrid;
  const D3D12DDI_NODE_LIST_ENTRY_0108      *pInputNodes;
  const D3D12DDI_NODE_LIST_ENTRY_0108      *pNodesSharingInputWithThisNode;
  UINT                                     NumOutputs;
  const D3D12DDI_NODE_OUTPUT_0108          *pOutputs;
} D3D12DDI_BROADCASTING_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.

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.

pDispatchGrid

Se o nó tiver um tamanho de grade de expedição fixo, ele será especificado aqui como um valor de 3 componentes. Caso contrário, isso é nullptr.

pMaxDispatchGrid

Se o nó obtém o tamanho da grade de expedição como parte de seu registro de entrada, o tamanho máximo da grade de expedição é especificado aqui como um valor de três componentes. Caso contrário, isso é nullptr.

pRecordDispatchGrid

Se nullptr, o registro de saída não conterá SV_DispatchGrid. Caso contrário, aponta para uma descrição de como SV_DispatchGrid aparece no registro de saída. Consulte [D3D12DDI_RECORD_DISPATCH_GRID_0108].

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