VkSwapchainPresentModesCreateInfoEXT
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;
sTypeis a VkStructureType value identifying this structure.pNextisNULLor a pointer to a structure extending this structure.presentModeCountis the number of presentation modes provided.pPresentModesis a list of presentation modes withpresentModeCountentries
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
VUID-VkSwapchainPresentModesCreateInfoEXT-presentMode-07764
VkSwapchainCreateInfoKHR::presentMode must be included in
pPresentModes
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
VUID-VkSwapchainPresentModesCreateInfoEXT-presentModeCount-arraylength
presentModeCount must be greater than 0