Structure specifying parameters for the generation of commands.

Valid Usage

• The provided pipeline must match the pipeline bound at execution time
• If the indirectCommandsLayout uses a token of INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV, then the pipeline must have been created with multiple shader groups
• If the indirectCommandsLayout uses a token of INDIRECT_COMMANDS_TOKEN_TYPE_SHADER_GROUP_NV, then the pipeline must have been created with PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV set in VkGraphicsPipelineCreateInfo::flags
• If the indirectCommandsLayout uses a token of INDIRECT_COMMANDS_TOKEN_TYPE_PUSH_CONSTANT_NV, then the pipeline`s VkPipelineLayout must match the VkIndirectCommandsLayoutTokenNV::pushconstantPipelineLayout
• streamCount must match the indirectCommandsLayout’s streamCount
• If pipelineBindPoint is of type PIPELINE_BIND_POINT_COMPUTE, then the pipeline must have been created with the flag PIPELINE_CREATE_INDIRECT_BINDABLE_BIT_NV
• If pipelineBindPoint is of type PIPELINE_BIND_POINT_COMPUTE, then the pipeline must have been created with a VkComputePipelineIndirectBufferInfoNV structure specifying a valid address where its metadata will be saved
• If pipelineBindPoint is of type PIPELINE_BIND_POINT_COMPUTE, then CmdUpdatePipelineIndirectBufferNV must have been called on that pipeline to save its metadata to a device address
• If pipelineBindPoint is of type PIPELINE_BIND_POINT_COMPUTE, and if INDIRECT_COMMANDS_TOKEN_TYPE_PIPELINE_NV is used, then pipeline must be NULL_HANDLE
• sequencesCount must be less or equal to VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::maxIndirectSequenceCount and VkGeneratedCommandsMemoryRequirementsInfoNV::maxSequencesCount that was used to determine the preprocessSize
• preprocessBuffer must have the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set in its usage flag
• preprocessOffset must be aligned to VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minIndirectCommandsBufferOffsetAlignment
• If preprocessBuffer is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object
• preprocessSize must be at least equal to the memory requirement`s size returned by GetGeneratedCommandsMemoryRequirementsNV using the matching inputs (indirectCommandsLayout, …​) as within this structure
• sequencesCountBuffer can be set if the actual used count of sequences is sourced from the provided buffer. In that case the sequencesCount serves as upper bound
• If sequencesCountBuffer is not NULL_HANDLE, its usage flag must have the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
• If sequencesCountBuffer is not NULL_HANDLE, sequencesCountOffset must be aligned to VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minSequencesCountBufferOffsetAlignment
• If sequencesCountBuffer is not NULL_HANDLE and is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object
• If indirectCommandsLayout’s INDIRECT_COMMANDS_LAYOUT_USAGE_INDEXED_SEQUENCES_BIT_NV is set, sequencesIndexBuffer must be set otherwise it must be NULL_HANDLE
• If sequencesIndexBuffer is not NULL_HANDLE, its usage flag must have the BUFFER_USAGE_INDIRECT_BUFFER_BIT bit set
• If sequencesIndexBuffer is not NULL_HANDLE, sequencesIndexOffset must be aligned to VkPhysicalDeviceDeviceGeneratedCommandsPropertiesNV::minSequencesIndexBufferOffsetAlignment
• If sequencesIndexBuffer is not NULL_HANDLE and is non-sparse then it must be bound completely and contiguously to a single VkDeviceMemory object
• If the indirectCommandsLayout uses a token of INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_TASKS_NV, then the pipeline must contain a shader stage using the MeshNV Execution Model
• If the indirectCommandsLayout uses a token of INDIRECT_COMMANDS_TOKEN_TYPE_DRAW_MESH_TASKS_NV, then the pipeline must contain a shader stage using the MeshEXT Execution Model

Valid Usage (Implicit)

• sType must be STRUCTURE_TYPE_GENERATED_COMMANDS_INFO_NV
• pNext must be NULL
• pipelineBindPoint must be a valid VkPipelineBindPoint value
• pipeline must be a valid VkPipeline handle
• indirectCommandsLayout must be a valid VkIndirectCommandsLayoutNV handle
• pStreams must be a valid pointer to an array of streamCount valid VkIndirectCommandsStreamNV structures
• preprocessBuffer must be a valid VkBuffer handle
• If sequencesCountBuffer is not NULL_HANDLE, sequencesCountBuffer must be a valid VkBuffer handle
• If sequencesIndexBuffer is not NULL_HANDLE, sequencesIndexBuffer must be a valid VkBuffer handle
• streamCount must be greater than 0
• Each of indirectCommandsLayout, pipeline, preprocessBuffer, sequencesCountBuffer, and sequencesIndexBuffer that are valid handles of non-ignored parameters must have been created, allocated, or retrieved from the same VkDevice

See Also

VkIndirectCommandsStreamNV, CmdExecuteGeneratedCommandsNV, CmdPreprocessGeneratedCommandsNV

Layout

struct VkGeneratedCommandsInfoNV {
    VkStructureType sType;
    void const * pNext;
    VkPipelineBindPoint pipelineBindPoint;
    VkPipeline pipeline;
    VkIndirectCommandsLayoutNV indirectCommandsLayout;
    uint32_t streamCount;
    VkIndirectCommandsStreamNV const * pStreams;
    uint32_t sequencesCount;
    VkBuffer preprocessBuffer;
    VkDeviceSize preprocessOffset;
    VkDeviceSize preprocessSize;
    VkBuffer sequencesCountBuffer;
    VkDeviceSize sequencesCountOffset;
    VkBuffer sequencesIndexBuffer;
    VkDeviceSize sequencesIndexOffset;
}