vkCmdPushDescriptorSet2(3)

Name

vkCmdPushDescriptorSet2 - Pushes descriptor updates into a command buffer

C Specification

Alternatively, to push descriptor updates into a command buffer, call:

// Provided by VK_VERSION_1_4
void vkCmdPushDescriptorSet2(
    VkCommandBuffer                             commandBuffer,
    const VkPushDescriptorSetInfo*              pPushDescriptorSetInfo);

or the equivalent command

// Provided by VK_KHR_maintenance6 with VK_KHR_push_descriptor
void vkCmdPushDescriptorSet2KHR(
    VkCommandBuffer                             commandBuffer,
    const VkPushDescriptorSetInfo*              pPushDescriptorSetInfo);

Parameters

commandBuffer is the command buffer that the descriptors will be recorded in.
pPushDescriptorSetInfo is a pointer to a VkPushDescriptorSetInfo structure.

Description

Valid Usage

VUID-vkCmdPushDescriptorSet2-pPushDescriptorSetInfo-09468
Each bit in pPushDescriptorSetInfo->stageFlags must be a stage supported by the commandBuffer’s parent VkCommandPool’s queue family
VUID-vkCmdPushDescriptorSet2-None-10357
If the VK_KHR_push_descriptor extension is not enabled, pushDescriptor must be enabled

Valid Usage (Implicit)

VUID-vkCmdPushDescriptorSet2-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdPushDescriptorSet2-pPushDescriptorSetInfo-parameter
pPushDescriptorSetInfo must be a valid pointer to a valid VkPushDescriptorSetInfo structure
VUID-vkCmdPushDescriptorSet2-commandBuffer-recording
commandBuffer must be in the recording state
VUID-vkCmdPushDescriptorSet2-commandBuffer-cmdpool
The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations
VUID-vkCmdPushDescriptorSet2-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