структура D3D12DDI_BROADCASTING_LAUNCH_NODE_PROPERTIES_0108 (d3d12umddi.h)

Статья
07/16/2024

Структура D3D12DDI_BROADCASTING_LAUNCH_NODE_PROPERTIES_0108 описывает свойства узла запуска трансляции в рабочем графе.

Синтаксис

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;

Члены

FinalName

Структура D3D12DDI_NODE_ID_0108, указывающая окончательное имя узла после любых необязательных переименований, выполненных на уровне приложения.

bProgramEntry

Если значение TRUE, текущий узел является записью программы и отображается в списке pEntrypoints в D3D12DDI_WORK_GRAPH_DESC_0108. Таким образом, этот параметр является избыточным, но он присутствует для ясности. Шейдер, возможно, не объявил, что узел является точкой входа, но среда выполнения, возможно, определила, что она должна быть одной, или в API, выбор может быть переопределен каким-то образом. Этот элемент всегда имеет значение TRUE для узла, который не предназначен для других узлов в графе.

InputNodeIOKind

Перечисление D3D12DDI_NODE_IO_KIND_0108, указывающее класс входных данных. См.объявление входных данных узла .

InputNodeIOFlags

Флаги, предоставляющие дополнительные сведения о входных ввода-выводах узла. См. флаги в D3D12DDI_NODE_IO_FLAGS_FLAG_MASKD3D12DDI_NODE_IO_FLAGS_0108. Для входных данных единственным флагом, который применяется, является D3D12DDI_NODE_IO_FLAG_TRACK_RW_INPUT_SHARING.

InputRecordSizeInBytes

Размер входной записи в байтах. Может иметь значение 0, если InputNodeIOKindD3D12DDI_NODE_IO_KIND_EMPTY_INPUT_0108.

GroupSharedUsageInBytes

Размер общего использования группы узлом в байтах.

MaxRecursionDepth

Максимальная рекурсия, объявленная шейдером. Значение 0 означает отсутствие рекурсии.

pLocalRootArgumentsTableIndex

Если локальная корневая сигнатура была связана с шейдером и /или шейдер явно объявил индекс локальной корневой таблицы аргументов, который он хочет использовать, индекс на основе 0 указывает здесь. Среда выполнения может иметь автоматическое назначение расположения. Если локальная корневая подпись не связана с шейдером, это будет nullptr.

pShareInputOfNode

Необязательный указатель на узел, который использует те же входные данные с этим узлом или nullptr, если текущий узел не предоставляет общий доступ к входным данным другого узла. Если этот узел предоставляет общий доступ к входным данным из другого узла в рабочем графе, pShareInputOfNode указывает на этот узел, представленный структурой D3D12DDI_NODE_0108. Если несколько узлов находятся в наборе общего доступа к входным данным, все, кроме исходного узла, указывают на исходный узел, а исходный узел задает pNodesSharingInputWithThisNode параметр, указывающий на другие.

pDispatchGrid

Если узел имеет фиксированный размер сетки отправки, он указан здесь как 3-компонентное значение. В противном случае это nullptr.

pMaxDispatchGrid

Если узел получает размер сетки отправки в рамках входной записи, максимальный размер сетки отправки указывается здесь как 3-компонентное значение. В противном случае это nullptr.

pRecordDispatchGrid

Если nullptr, выходная запись не содержит SV_DispatchGrid. Кроме того, указывает на описание того, как SV_DispatchGrid отображается в выходной записи. См. статью [D3D12DDI_RECORD_DISPATCH_GRID_0108].

pInputNodes

Указатель на список (D3D12DDI_NODE_LIST_ENTRY_0108) узлов ((D3D12DDI_NODE_0108) для текущего узла. pInputNodesnullptr, если узлы не предназначены для этого узла.

pNodesSharingInputWithThisNode

Указатель на список (D3D12DDI_NODE_LIST_ENTRY_0108) узлов ((D3D12DDI_NODE_0108), которые совместно используют входные данные с текущим узлом. pNodesSharingInputWithThisNodenullptr, если узлы не используют входные данные с этим узлом.

NumOutputs

Число узлов, в которые выводится этот узел.

pOutputs

Указатель на массив NumOutputsD3D12DDI_NODE_OUTPUT_0108 структуры, содержащие определения выходных данных. pOutputs nullptr, если этот узел не выводится на другие узлы.

Замечания

Все свойства, перечисленные здесь, имеют приоритет над (переопределением), которые могли быть объявлены в шейдере для узла. Драйвер всегда должен использовать свойства, перечисленные здесь, в качестве окончательных выборов свойств. Если драйвер будет заботиться о том, было ли что-то переопределено, он может сравнить любой параметр здесь с тем, что шейдер объявил.

Дополнительные сведения см. в рабочих графов.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 11 версии 24H2 (WDDM 3.2)
заголовка	d3d12umddi.h

См. также

D3D12DDI_SHADER_NODE_0108

Поделиться через