C Specification

The VkReleaseSwapchainImagesInfoEXT structure is defined as:

// Provided by VK_EXT_swapchain_maintenance1
typedef struct VkReleaseSwapchainImagesInfoEXT {
    VkStructureType    sType;
    const void*        pNext;
    VkSwapchainKHR     swapchain;
    uint32_t           imageIndexCount;
    const uint32_t*    pImageIndices;
} VkReleaseSwapchainImagesInfoEXT;

Members

  • sType is the type of this structure.

  • pNext is NULL or a pointer to a structure extending this structure.

  • swapchain is a swapchain to which images are being released.

  • imageIndexCount is the number of image indices to be released.

  • pImageIndices is a pointer to an array of indices into the array of swapchain’s presentable images, with imageIndexCount entries.

Description

Valid Usage

  • VUID-VkReleaseSwapchainImagesInfoEXT-pImageIndices-07785
    Each element of pImageIndices must be the index of a presentable image acquired from the swapchain specified by swapchain

  • VUID-VkReleaseSwapchainImagesInfoEXT-pImageIndices-07786
    All uses of presentable images identified by elements of pImageIndices must have completed execution

Valid Usage (Implicit)

  • VUID-VkReleaseSwapchainImagesInfoEXT-sType-sType
    sType must be VK_STRUCTURE_TYPE_RELEASE_SWAPCHAIN_IMAGES_INFO_EXT

  • VUID-VkReleaseSwapchainImagesInfoEXT-pNext-pNext
    pNext must be NULL

  • VUID-VkReleaseSwapchainImagesInfoEXT-swapchain-parameter
    swapchain must be a valid VkSwapchainKHR handle

  • VUID-VkReleaseSwapchainImagesInfoEXT-pImageIndices-parameter
    pImageIndices must be a valid pointer to an array of imageIndexCount uint32_t values

  • VUID-VkReleaseSwapchainImagesInfoEXT-imageIndexCount-arraylength
    imageIndexCount must be greater than 0

Host Synchronization

  • Host access to swapchain must be externally synchronized

See Also

VK_EXT_swapchain_maintenance1, VkStructureType, VkSwapchainKHR, vkReleaseSwapchainImagesEXT

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

Copyright 2014-2023 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0