Structures

VkSwapchainPresentModesCreateInfoEXT

All presentation modes usable by the swapchain

Applications can modify the presentation mode used by the swapchain on a per-presentation basis. However, all presentation modes the application intends to use with the swapchain must be specified at swapchain creation time. To specify more than one presentation mode when creating a swapchain, include the VkSwapchainPresentModesCreateInfoEXT structure in the pNext chain of the VkSwapchainCreateInfoKHR structure.

The VkSwapchainPresentModesCreateInfoEXT structure is defined as:

typedef struct VkSwapchainPresentModesCreateInfoEXT {
    VkStructureType sType;
    const void* pNext;
    uint32_t presentModeCount;
    // Length of the pPresentModes array;
    const VkPresentModeKHR* pPresentModes;
    // Presentation modes which will be usable with this swapchain;
} VkSwapchainPresentModesCreateInfoEXT;
  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • presentModeCount is the number of presentation modes provided.
  • pPresentModes is a list of presentation modes with presentModeCount entries

Valid Usage

VUID-VkSwapchainPresentModesCreateInfoEXT-None-07762

Each entry in pPresentModes must be one of the VkPresentModeKHR values returned by vkGetPhysicalDeviceSurfacePresentModesKHR for the surface

VUID-VkSwapchainPresentModesCreateInfoEXT-presentModeFifoLatestReady-10160

If the presentModeFifoLatestReady feature is not enabled, pPresentModes must not contain VK_PRESENT_MODE_FIFO_LATEST_READY_EXT

VUID-VkSwapchainPresentModesCreateInfoEXT-pPresentModes-07763

The entries in pPresentModes must be a subset of the present modes returned in VkSurfacePresentModeCompatibilityEXT::pPresentModes, given VkSwapchainCreateInfoKHR::presentMode in VkSurfacePresentModeEXT

Valid Usage (Implicit)

VUID-VkSwapchainPresentModesCreateInfoEXT-sType-sType

sType must be VK_STRUCTURE_TYPE_SWAPCHAIN_PRESENT_MODES_CREATE_INFO_EXT

VUID-VkSwapchainPresentModesCreateInfoEXT-pPresentModes-parameter

pPresentModes must be a valid pointer to an array of presentModeCount valid VkPresentModeKHR values