VulkanHub
Function Prototype

vkCmdBindTransformFeedbackBuffersEXT

Bind transform feedback buffers to a command buffer

To bind transform feedback buffers to a command buffer for use in subsequent drawing commands, call:

void vkCmdBindTransformFeedbackBuffersEXT(
    VkCommandBuffer commandBuffer,
    uint32_t firstBinding,
    uint32_t bindingCount,
    const VkBuffer* pBuffers,
    const VkDeviceSize* pOffsets,
    const VkDeviceSize* pSizes);
  • commandBuffer is the command buffer into which the command is recorded.
  • firstBinding is the index of the first transform feedback binding whose state is updated by the command.
  • bindingCount is the number of transform feedback bindings whose state is updated by the command.
  • pBuffers is a pointer to an array of buffer handles.
  • pOffsets is a pointer to an array of buffer offsets.
  • pSizes is NULL or a pointer to an array of VkDeviceSize buffer sizes, specifying the maximum number of bytes to capture to the corresponding transform feedback buffer. If pSizes is NULL, it is equivalent to setting a pSizes array where every element is VK_WHOLE_SIZE.

The values taken from elements i of pBuffers, pOffsets and pSizes replace the current state for the transform feedback binding firstBinding + i, for i in [0, bindingCount). The transform feedback binding is updated to start at the offset indicated by pOffsets[i] from the start of the buffer pBuffers[i].

When an element of pSizes[i] is VK_WHOLE_SIZE, or pSizes is NULL, the effective range is calculated by taking the size of pBuffers[i] minus pOffsets[i]. Otherwise, the effective range is equal to the element in pSizes[i].

Valid Usage

VUID-vkCmdBindTransformFeedbackBuffersEXT-transformFeedback-02355

VkPhysicalDeviceTransformFeedbackFeaturesEXT::transformFeedbackmust be enabled

VUID-vkCmdBindTransformFeedbackBuffersEXT-firstBinding-02356

firstBinding must be less than VkPhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers

VUID-vkCmdBindTransformFeedbackBuffersEXT-firstBinding-02357

The sum of firstBinding and bindingCount must be less than or equal to VkPhysicalDeviceTransformFeedbackPropertiesEXT::maxTransformFeedbackBuffers

VUID-vkCmdBindTransformFeedbackBuffersEXT-None-02365

Transform feedback must not be active when the vkCmdBindTransformFeedbackBuffersEXT command is recorded

VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02358

All elements of pOffsets must be less than the size of the corresponding element in pBuffers

VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02359

All elements of pOffsets must be a multiple of 4

VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-02360

All elements of pBuffers must have been created with the VK_BUFFER_USAGE_TRANSFORM_FEEDBACK_BUFFER_BIT_EXT usage flag set

VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-02363

All elements of pOffsets plus the effective size of the element, must be less than or equal to the size of the corresponding buffer in pBuffers

VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-02364

Each element of pBuffers that is non-sparse must be bound completely and contiguously to a single VkDeviceMemory object

Valid Usage (Implicit)

VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-parameter

commandBuffer must be a valid VkCommandBuffer handle

VUID-vkCmdBindTransformFeedbackBuffersEXT-pBuffers-parameter

pBuffers must be a valid pointer to an array of bindingCount valid VkBuffer handles

VUID-vkCmdBindTransformFeedbackBuffersEXT-pOffsets-parameter

pOffsets must be a valid pointer to an array of bindingCount VkDeviceSize values

VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-recording

commandBuffer must be in the recording state

VUID-vkCmdBindTransformFeedbackBuffersEXT-commandBuffer-cmdpool

The VkCommandPool that commandBuffer was allocated from must support VK_QUEUE_GRAPHICS_BIT operations

VUID-vkCmdBindTransformFeedbackBuffersEXT-videocoding

This command must only be called outside of a video coding scope

VUID-vkCmdBindTransformFeedbackBuffersEXT-bindingCount-arraylength

bindingCount must be greater than 0

VUID-vkCmdBindTransformFeedbackBuffersEXT-commonparent

Both of commandBuffer, and the elements of pBuffers must have been created, allocated, or retrieved from the same VkDevice

Host Synchronization

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