VulkanHub
Function Prototype

vkCmdSetDescriptorBufferOffsets2EXT

Setting descriptor buffer offsets in a command buffer

To set descriptor buffer offsets in a command buffer, call:

void vkCmdSetDescriptorBufferOffsets2EXT(
    VkCommandBuffer commandBuffer,
    const VkSetDescriptorBufferOffsetsInfoEXT* pSetDescriptorBufferOffsetsInfo);
  • commandBuffer is the command buffer in which the descriptor buffer offsets will be set.
  • pSetDescriptorBufferOffsetsInfo is a pointer to a VkSetDescriptorBufferOffsetsInfoEXT structure.

Valid Usage

VUID-vkCmdSetDescriptorBufferOffsets2EXT-commandBuffer-11295

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

VUID-vkCmdSetDescriptorBufferOffsets2EXT-commandBuffer-11296

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

VUID-vkCmdSetDescriptorBufferOffsets2EXT-descriptorBuffer-09470

The descriptorBuffer feature must be enabled

VUID-vkCmdSetDescriptorBufferOffsets2EXT-pSetDescriptorBufferOffsetsInfo-09471

Each bit in pSetDescriptorBufferOffsetsInfo→stageFlags must be a stage supported by the commandBuffer’s parent VkCommandPool’s queue family

Valid Usage (Implicit)

VUID-vkCmdSetDescriptorBufferOffsets2EXT-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdSetDescriptorBufferOffsets2EXT-pSetDescriptorBufferOffsetsInfo-parameter

pSetDescriptorBufferOffsetsInfo must be a valid pointer to a valid VkSetDescriptorBufferOffsetsInfoEXT structure

VUID-vkCmdSetDescriptorBufferOffsets2EXT-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdSetDescriptorBufferOffsets2EXT-commandBuffer-cmdpool

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

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