C Specification

The tile properties queried using VK_QCOM_tile_properties depend on the size of the reserved tile memory by the application. This size can be specified by the following structure to VkRenderPassCreateInfo, VkRenderPassCreateInfo2 , or VkRenderingInfo to specify the reserved tile memory size for the render pass object.

For dynamic render passes, this structure can be attached to the pNext member of VkRenderingInfo passed to vkGetDynamicRenderingTilePropertiesQCOM.

The VkTileMemorySizeInfoQCOM structure is defined as:

// Provided by VK_QCOM_tile_memory_heap with VK_QCOM_tile_properties
typedef struct VkTileMemorySizeInfoQCOM {
    VkStructureType    sType;
    const void*        pNext;
    VkDeviceSize       size;
} VkTileMemorySizeInfoQCOM;

Members

  • sType is a VkStructureType value identifying this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • size is the size in bytes of tile memory used by the render pass or preserved for later use.

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.

Note

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
  • VUID-VkTileMemorySizeInfoQCOM-size-10729
    size must be less than or equal to the largest size memory heap with the VK_MEMORY_HEAP_TILE_MEMORY_BIT_QCOM property.

Valid Usage (Implicit)
  • VUID-VkTileMemorySizeInfoQCOM-sType-sType
    sType must be VK_STRUCTURE_TYPE_TILE_MEMORY_SIZE_INFO_QCOM

See Also

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.

Copyright 2014-2025 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0