VkSwapchainPresentModesCreateInfoKHR
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 VkSwapchainPresentModesCreateInfoKHR structure in the
pNext chain of the VkSwapchainCreateInfoKHR structure.
The VkSwapchainPresentModesCreateInfoKHR structure is defined as:
typedef struct VkSwapchainPresentModesCreateInfoKHR {
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;
} VkSwapchainPresentModesCreateInfoKHR;
pub struct SwapchainPresentModesCreateInfoKHR {
s_type: vk::StructureType,
p_next: *const c_void,
present_mode_count: u32,
/// Length of the pPresentModes array
p_present_modes: *const vk::PresentModeKHR,
/// Presentation modes which will be usable with this swapchain
}
typedef VkSwapchainPresentModesCreateInfoKHR VkSwapchainPresentModesCreateInfoEXT;
type SwapchainPresentModesCreateInfoEXT = vk::SwapchainPresentModesCreateInfoKHR;
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-VkSwapchainPresentModesCreateInfoKHR-None-07762
Each entry in pPresentModes must be one of the VkPresentModeKHR
values returned by vkGetPhysicalDeviceSurfacePresentModesKHR for
the surface
VUID-VkSwapchainPresentModesCreateInfoKHR-presentModeFifoLatestReady-10160
If the presentModeFifoLatestReady feature is not enabled, pPresentModes
must not contain VK_PRESENT_MODE_FIFO_LATEST_READY_KHR
VUID-VkSwapchainPresentModesCreateInfoKHR-pPresentModes-07763
The entries in pPresentModes must be a subset of the present modes
returned in
VkSurfacePresentModeCompatibilityKHR::pPresentModes, given
VkSwapchainCreateInfoKHR::presentMode in
VkSurfacePresentModeKHR
VUID-VkSwapchainPresentModesCreateInfoKHR-presentMode-07764
VkSwapchainCreateInfoKHR::presentMode must be included in
pPresentModes
Valid Usage (Implicit)
VUID-VkSwapchainPresentModesCreateInfoKHR-sType-sType
sType must be VK_STRUCTURE_TYPE_SWAPCHAIN_PRESENT_MODES_CREATE_INFO_KHR
VUID-VkSwapchainPresentModesCreateInfoKHR-pPresentModes-parameter
pPresentModes must be a valid pointer to an array of presentModeCount valid VkPresentModeKHR values
VUID-VkSwapchainPresentModesCreateInfoKHR-presentModeCount-arraylength
presentModeCount must be greater than 0