Function Prototype

vkGetDeviceImageSparseMemoryRequirements

Query the memory requirements for a sparse image

To determine the sparse memory requirements for an image resource without creating an object, call:

void vkGetDeviceImageSparseMemoryRequirementsKHR(
    VkDevice device,
    const VkDeviceImageMemoryRequirements* pInfo,
    uint32_t* pSparseMemoryRequirementCount,
    VkSparseImageMemoryRequirements2* pSparseMemoryRequirements);
  • device is the logical device intended to own the image.
  • pInfo is a pointer to a VkDeviceImageMemoryRequirements structure containing parameters required for the memory requirements query.
  • pSparseMemoryRequirementCount is a pointer to an integer related to the number of sparse memory requirements available or queried, as described below.
  • pSparseMemoryRequirements is either NULL or a pointer to an array of VkSparseImageMemoryRequirements2 structures.

Valid Usage (Implicit)

VUID-vkGetDeviceImageSparseMemoryRequirements-pSparseMemoryRequirementCount-parameter

pSparseMemoryRequirementCount must be a valid pointer to a uint32_t value

VUID-vkGetDeviceImageSparseMemoryRequirements-pSparseMemoryRequirements-parameter

If the value referenced by pSparseMemoryRequirementCount is not 0, and pSparseMemoryRequirements is not NULL, pSparseMemoryRequirements must be a valid pointer to an array of pSparseMemoryRequirementCount VkSparseImageMemoryRequirements2 structures