vkCmdBindTileMemoryQCOM - Bind tile memory to a command buffer

Description

Calling cmdBindTileMemoryQCOM when pTileMemoryBindInfo is NULL is equivalent to binding no tile memory to the command buffer.

Valid Usage (Implicit)

• commandBuffer must be a valid CommandBuffer handle

• If pTileMemoryBindInfo is not NULL, pTileMemoryBindInfo must be a valid pointer to a valid TileMemoryBindInfoQCOM structure
• commandBuffer must be in the recording state
• The CommandPool that commandBuffer was allocated from must support QUEUE_COMPUTE_BIT, or QUEUE_GRAPHICS_BIT operations
• This command must only be called outside of a render pass instance
• 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 CommandPool that commandBuffer was allocated from must be externally synchronized

Command Properties

'

Conditional Rendering

vkCmdBindTileMemoryQCOM is not affected by conditional rendering

See Also

VK_QCOM_tile_memory_heap, CommandBuffer, TileMemoryBindInfoQCOM

VkTileMemoryBindInfoQCOM - Structure specifying tile memory to bind

Description

memory is used to bind this memory object to tile memory for all subsequent commands in the commandBuffer. Tile memory contents for ranges in the heap outside the bound memory are discarded and become undefined for the active tile memory scope if an action command is executed.

For secondary command buffers executing within a render pass instance, the active bound tile memory object is provided with this structure included in the pNext chain of CommandBufferInheritanceInfo.

If this structure was not specified since recording started for commandBuffer, no tile memory is bound to the command buffer and all contents become undefined for the tile memory scope if an action command is executed.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_memory_heap, DeviceMemory, StructureType, cmdBindTileMemoryQCOM

VkPhysicalDeviceTileMemoryHeapFeaturesQCOM - Structure describing whether the tile memory heap features can be supported by an implementation

Members

This structure describes the following features:

Description

If the PhysicalDeviceTileMemoryHeapFeaturesQCOM structure is included in the pNext chain of the PhysicalDeviceFeatures2 structure passed to getPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a Device with any features described by PhysicalDeviceTileMemoryHeapFeaturesQCOM, it must add an instance of the structure, with the desired feature members set to TRUE, to the pNext chain of DeviceCreateInfo when creating the Device.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_memory_heap, Bool32, StructureType

VkPhysicalDeviceTileMemoryHeapPropertiesQCOM - Structure describing tile memory heap properties that can be supported by an implementation

Description

If the PhysicalDeviceTileMemoryHeapPropertiesQCOM structure is included in the pNext chain of the PhysicalDeviceProperties2 structure passed to getPhysicalDeviceProperties2, it is filled in with each corresponding implementation-dependent property.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_memory_heap, Bool32, StructureType

VkTileMemorySizeInfoQCOM - Structure describing tile memory size in use in a render pass instance

Description

The returned tile properties are invalid if the size is not equal to the bound tile memory’s allocation size when the render pass is executed.

If this structure is not provided, the size of the reserved region defaults to 0.

Tile memory is reserved for application use by binding tile memory objects to the command buffer.

The size provided by this command is informational only for use when evaluating tile properties. If the application does not need to query the tile properties, then this size can be safely omitted.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_memory_heap, VK_QCOM_tile_properties, DeviceSize, StructureType

VkTileMemoryRequirementsQCOM - Structure specifying tile memory requirements

Description

The size and alignment must be used when the resource is bound to a DeviceMemory object that was allocated from a MemoryType that has a heapIndex that corresponds to a MemoryHeap with the MEMORY_HEAP_TILE_MEMORY_BIT_QCOM property.

If the resource cannot be bound to tile memory, then size and alignment is filled with zero by the implementation.

Valid Usage (Implicit)

See Also

VK_QCOM_tile_memory_heap, DeviceSize, StructureType