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;
sType
is a VkStructureType value identifying this structure.pNext
isNULL
or a pointer to a structure extending this structure.presentModeCount
is the number of presentation modes provided.pPresentModes
is a list of presentation modes withpresentModeCount
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
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