VKDESTROYIMAGE(3)

NAME
vkDestroyImage - Destroy an image object

C SPECIFICATION

    void vkDestroyImage(
        VkDevice                                    device,
        VkImage                                     image,
        const VkAllocationCallbacks*                pAllocator);

PARAMETERS

device
    Logical device which owns the object.

image
    The handle of the object to destroy.

DESCRIPTION

vkDestroyImage destroys the image object whose handle is specified in image. image must be a valid handle to an image object created through a successful call to vkCreateImage on device. Attempts to destroy VK_NULL_HANDLE are silently ignored. After an image has been destroyed, its handle becomes invalid and must not be accessed again. Additionally, views of images immediately become invalid once the parent image has been destroyed.

VALID USAGE

    • device must be a valid VkDevice handle

    • If image is not VK_NULL_HANDLE, image must be a valid VkImage handle

    • If pAllocator is not NULL, pAllocator must be a pointer to a valid VkAllocationCallbacks structure

    • If image is a valid handle, it must have been created, allocated or retrieved from device

    • Each of device and image that are valid handles must have been created, allocated or retrieved from the same VkPhysicalDevice

    • All submitted commands that refer to image, either directly or via a VkImageView, must have completed execution

    • If VkAllocationCallbacks were provided when image was created, a compatible set of callbacks must be provided here

    • If no VkAllocationCallbacks were provided when image was created, pAllocator must be NULL

HOST SYNCHRONIZATION

    • Host access to image must be externally synchronized

SEE ALSO

vkCreateImage

COPYRIGHT

Copyright © 2014-2016 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

AUTHOR

Khronos Group
    Author.