C Specification

To determine the memory requirements for an image resource which is not created with the VK_IMAGE_CREATE_DISJOINT_BIT flag set, call:

// Provided by VK_VERSION_1_0
void vkGetImageMemoryRequirements(
VkDevice                                    device,
VkImage                                     image,
VkMemoryRequirements*                       pMemoryRequirements);

Parameters

• device is the logical device that owns the image.

• image is the image to query.

• pMemoryRequirements is a pointer to a VkMemoryRequirements structure in which the memory requirements of the image object are returned.

Description

Valid Usage
• VUID-vkGetImageMemoryRequirements-image-01588
image must not have been created with the VK_IMAGE_CREATE_DISJOINT_BIT flag set

• VUID-vkGetImageMemoryRequirements-image-04004
If image was created with the VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID external memory handle type, then image must be bound to memory

Valid Usage (Implicit)
• VUID-vkGetImageMemoryRequirements-device-parameter
device must be a valid VkDevice handle

• VUID-vkGetImageMemoryRequirements-image-parameter
image must be a valid VkImage handle

• VUID-vkGetImageMemoryRequirements-pMemoryRequirements-parameter
pMemoryRequirements must be a valid pointer to a VkMemoryRequirements structure

• VUID-vkGetImageMemoryRequirements-image-parent
image must have been created, allocated, or retrieved from device

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-2022 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0