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 the
VK_INDIRECT_COMMANDS_LAYOUT_USAGE_EXPLICIT_PREPROCESS_BIT_NV` bit
set
Valid Usage (Implicit)
VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-parameter
commandBuffer
must be a valid VkCommandBuffer handle
VUID-vkCmdPreprocessGeneratedCommandsNV-pGeneratedCommandsInfo-parameter
pGeneratedCommandsInfo
must be a valid pointer to a valid VkGeneratedCommandsInfoNV structure
VUID-vkCmdPreprocessGeneratedCommandsNV-commandBuffer-recording
commandBuffer
must be in the recording state
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
thatcommandBuffer
was allocated from must be externally synchronized ::