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 eitherNULL
or a pointer to an array ofVkSparseImageMemoryRequirements2
structures.
Valid Usage (Implicit)
VUID-vkGetDeviceImageSparseMemoryRequirements-device-parameter
device
must be a valid VkDevice handle
VUID-vkGetDeviceImageSparseMemoryRequirements-pInfo-parameter
pInfo
must be a valid pointer to a valid VkDeviceImageMemoryRequirements structure
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