VkPipelineShaderStageNodeCreateInfoAMDX
The VkPipelineShaderStageNodeCreateInfoAMDX
structure is defined as:
typedef struct VkPipelineShaderStageNodeCreateInfoAMDX {
VkStructureType sType;
const void* pNext;
const char* pName;
uint32_t index;
} VkPipelineShaderStageNodeCreateInfoAMDX;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.pName
is the shader name to use when creating a node in an execution graph. IfpName
isNULL
, the name of the entry point specified in SPIR-V is used as the shader name.index
is the shader index to use when creating a node in an execution graph. Ifindex
isVK_SHADER_INDEX_UNUSED_AMDX
then the original index is used, either as specified by theShaderIndexAMDX
execution mode, or0
if that too is not specified.
When included in the pNext
chain of a
VkPipelineShaderStageCreateInfo structure, this structure specifies
the shader name and shader index of a node when creating an execution graph
pipeline.
If this structure is omitted, the shader name is set to the name of the
entry point in SPIR-V and the shader index is set to 0
.
When dispatching a node from another shader, the name is fixed at pipeline creation, but the index can be set dynamically. By associating multiple shaders with the same name but different indexes, applications can dynamically select different nodes to execute. Applications must ensure each node has a unique name and index.
Shaders with the same name must be of the same type - e.g. a compute and graphics shader, or even two compute shaders where one is coalescing and the other is not, cannot share the same name.
Valid Usage (Implicit)
VUID-VkPipelineShaderStageNodeCreateInfoAMDX-sType-sType
sType
must be VK_STRUCTURE_TYPE_PIPELINE_SHADER_STAGE_NODE_CREATE_INFO_AMDX
VUID-VkPipelineShaderStageNodeCreateInfoAMDX-pName-parameter
If pName
is not NULL
, pName
must be a null-terminated UTF-8 string