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
isNULL
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. |
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.