VulkanHub
Function Prototype

vkCmdPushDescriptorSetWithTemplate2

Pushes descriptor updates into a command buffer using a descriptor update template

To use a descriptor update template to specify the push descriptors to update in a command buffer, call:

void vkCmdPushDescriptorSetWithTemplate2(
    VkCommandBuffer commandBuffer,
    const VkPushDescriptorSetWithTemplateInfo* pPushDescriptorSetWithTemplateInfo);

void vkCmdPushDescriptorSetWithTemplate2KHR(
    VkCommandBuffer commandBuffer,
    const VkPushDescriptorSetWithTemplateInfo* pPushDescriptorSetWithTemplateInfo);
  • commandBuffer is the command buffer that the descriptors will be recorded in.
  • pPushDescriptorSetWithTemplateInfo is a pointer to a VkPushDescriptorSetWithTemplateInfo structure.

Valid Usage

VUID-vkCmdPushDescriptorSetWithTemplate2-commandBuffer-11295

If commandBuffer is a secondary command buffer, it must have begun with VkCommandBufferInheritanceDescriptorHeapInfoEXT::pSamplerHeapBindInfo equal to NULL

VUID-vkCmdPushDescriptorSetWithTemplate2-commandBuffer-11296

If commandBuffer is a secondary command buffer, it must have begun with VkCommandBufferInheritanceDescriptorHeapInfoEXT::pResourceHeapBindInfo equal to NULL

Valid Usage (Implicit)

VUID-vkCmdPushDescriptorSetWithTemplate2-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdPushDescriptorSetWithTemplate2-pPushDescriptorSetWithTemplateInfo-parameter

pPushDescriptorSetWithTemplateInfo must be a valid pointer to a valid VkPushDescriptorSetWithTemplateInfo structure

VUID-vkCmdPushDescriptorSetWithTemplate2-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdPushDescriptorSetWithTemplate2-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_COMPUTE_BIT, or VK_QUEUE_GRAPHICS_BIT operations

VUID-vkCmdPushDescriptorSetWithTemplate2-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