Function Prototype

vkCmdPreprocessGeneratedCommandsNV

Performs preprocessing for generated commands
primary / secondary
outside
graphics / compute
action

Commands can be preprocessed prior execution using the following command:

void vkCmdPreprocessGeneratedCommandsNV(
    VkCommandBuffer commandBuffer,
    const VkGeneratedCommandsInfoNV* pGeneratedCommandsInfo);
  • commandBuffer is the command buffer which does the preprocessing.
  • pGeneratedCommandsInfo is a pointer to a VkGeneratedCommandsInfoNV structure containing parameters affecting the preprocessing step.

Valid Usage

VUID-vkCmdPreprocessGeneratedCommandsNV-pGeneratedCommandsInfo-02927

pGeneratedCommandsInfo``s indirectCommandsLayout:normative{type="must"} have been created with theVK_INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV` bit set

Valid Usage (Implicit)

VUID-vkCmdPreprocessGeneratedCommandsNV-pGeneratedCommandsInfo-parameter

pGeneratedCommandsInfo must be a valid pointer to a valid VkGeneratedCommandsInfoNV structure

VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations

VUID-vkCmdPreprocessGeneratedCommandsNV-renderpass

This command must only be called outside of a render pass instance

VUID-vkCmdPreprocessGeneratedCommandsNV-videocoding

This command must only be called outside of a video coding scope

Host Synchronization

  • Host access to commandBuffer must be externally synchronized
  • Host access to the VkCommandPool that commandBuffer was allocated from must be externally synchronized ::