vkCmdBindTileMemoryQCOM(3)

Name

vkCmdBindTileMemoryQCOM - Bind tile memory to a command buffer

C Specification

To bind a range of tile memory to the command buffer, call:

// Provided by VK_QCOM_tile_memory_heap
void vkCmdBindTileMemoryQCOM(
    VkCommandBuffer                             commandBuffer,
    const VkTileMemoryBindInfoQCOM*             pTileMemoryBindInfo);

Parameters

  • commandBuffer is the command buffer that the tile memory will be bound to.

  • pTileMemoryBindInfo is VK_NULL_HANDLE or a pointer to a VkTileMemoryBindInfoQCOM structure defining how tile memory is bound.

Description

Calling vkCmdBindTileMemoryQCOM when pTileMemoryBindInfo is VK_NULL_HANDLE is equivalent to binding no tile memory to the command buffer.

Valid Usage (Implicit)
  • VUID-vkCmdBindTileMemoryQCOM-commandBuffer-parameter
    commandBuffer must be a valid VkCommandBuffer handle

  • VUID-vkCmdBindTileMemoryQCOM-pTileMemoryBindInfo-parameter
    If pTileMemoryBindInfo is not NULL, pTileMemoryBindInfo must be a valid pointer to a valid VkTileMemoryBindInfoQCOM structure

  • VUID-vkCmdBindTileMemoryQCOM-commandBuffer-recording
    commandBuffer must be in the recording state

  • VUID-vkCmdBindTileMemoryQCOM-commandBuffer-cmdpool
    The VkCommandPool that commandBuffer was allocated from must support graphics, or compute operations

  • VUID-vkCmdBindTileMemoryQCOM-renderpass
    This command must only be called outside of a render pass instance

  • VUID-vkCmdBindTileMemoryQCOM-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

Command Properties
Command Buffer Levels Render Pass Scope Video Coding Scope Supported Queue Types Command Type

Primary
Secondary

Outside

Outside

Graphics
Compute

State

Conditional Rendering

vkCmdBindTileMemoryQCOM is not affected by conditional rendering

Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.