vkCmdBindDescriptorBuffersEXT(3)

Name

vkCmdBindDescriptorBuffersEXT - Binding descriptor buffers to a command buffer

C Specification

To bind descriptor buffers to a command buffer, call:

// Provided by VK_EXT_descriptor_buffer
void vkCmdBindDescriptorBuffersEXT(
    VkCommandBuffer                             commandBuffer,
    uint32_t                                    bufferCount,
    const VkDescriptorBufferBindingInfoEXT*     pBindingInfos);

Parameters

commandBuffer is the command buffer that the descriptor buffers will be bound to.
bufferCount is the number of elements in the pBindingInfos array.
pBindingInfos is a pointer to an array of VkDescriptorBufferBindingInfoEXT structures.

Description

vkCmdBindDescriptorBuffersEXT causes any offsets previously set by vkCmdSetDescriptorBufferOffsetsEXT that use the bindings numbered [0.. bufferCount-1] to be no longer valid for subsequent bound pipeline commands. Any previously bound buffers at binding points greater than or equal to bufferCount are unbound.

Valid Usage

VUID-vkCmdBindDescriptorBuffersEXT-None-08047
The descriptorBuffer feature must be enabled
VUID-vkCmdBindDescriptorBuffersEXT-maxSamplerDescriptorBufferBindings-08048
There must be no more than VkPhysicalDeviceDescriptorBufferPropertiesEXT::maxSamplerDescriptorBufferBindings elements in pBindingInfos with VkDescriptorBufferBindingInfoEXT::usage containing VK_BUFFER_USAGE_SAMPLER_DESCRIPTOR_BUFFER_BIT_EXT
VUID-vkCmdBindDescriptorBuffersEXT-maxResourceDescriptorBufferBindings-08049
There must be no more than VkPhysicalDeviceDescriptorBufferPropertiesEXT::maxResourceDescriptorBufferBindings elements in pBindingInfos with VkDescriptorBufferBindingInfoEXT::usage containing VK_BUFFER_USAGE_RESOURCE_DESCRIPTOR_BUFFER_BIT_EXT
VUID-vkCmdBindDescriptorBuffersEXT-None-08050
There must be no more than 1 element in pBindingInfos with VkDescriptorBufferBindingInfoEXT::usage containing VK_BUFFER_USAGE_PUSH_DESCRIPTORS_DESCRIPTOR_BUFFER_BIT_EXT
VUID-vkCmdBindDescriptorBuffersEXT-bufferCount-08051
bufferCount must be less than or equal to VkPhysicalDeviceDescriptorBufferPropertiesEXT::maxDescriptorBufferBindings
VUID-vkCmdBindDescriptorBuffersEXT-pBindingInfos-08053
For any element of pBindingInfos, the buffer from which address was queried must have been created with the VK_BUFFER_USAGE_SAMPLER_DESCRIPTOR_BUFFER_BIT_EXT bit set if it contains sampler descriptor data
VUID-vkCmdBindDescriptorBuffersEXT-pBindingInfos-08054
For any element of pBindingInfos, the buffer from which address was queried must have been created with the VK_BUFFER_USAGE_RESOURCE_DESCRIPTOR_BUFFER_BIT_EXT bit set if it contains resource descriptor data
VUID-vkCmdBindDescriptorBuffersEXT-pBindingInfos-08055
For any element of pBindingInfos, usage must match the buffer from which address was queried
VUID-vkCmdBindDescriptorBuffersEXT-pBindingInfos-09947
For all elements of pBindingInfos, the buffer from which address was queried must have been created with the VK_BUFFER_USAGE_2_DATA_GRAPH_FOREIGN_DESCRIPTOR_BIT_ARM bit set if the command pool from which commandBuffer was allocated from was created with any element of VkDataGraphProcessingEngineCreateInfoARM::pProcessingEngines with isForeign set to VK_TRUE

Valid Usage (Implicit)

VUID-vkCmdBindDescriptorBuffersEXT-commandBuffer-parameter
commandBuffer must be a valid VkCommandBuffer handle
VUID-vkCmdBindDescriptorBuffersEXT-pBindingInfos-parameter
pBindingInfos must be a valid pointer to an array of bufferCount valid VkDescriptorBufferBindingInfoEXT structures
VUID-vkCmdBindDescriptorBuffersEXT-commandBuffer-recording
commandBuffer must be in the recording state
VUID-vkCmdBindDescriptorBuffersEXT-commandBuffer-cmdpool
The VkCommandPool that commandBuffer was allocated from must support graphics, compute, or data_graph operations
VUID-vkCmdBindDescriptorBuffersEXT-videocoding
This command must only be called outside of a video coding scope
VUID-vkCmdBindDescriptorBuffersEXT-bufferCount-arraylength
bufferCount must be greater than 0

Host Synchronization

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