Function Prototype

vkGetPhysicalDeviceSurfacePresentModes2EXT

Query supported presentation modes

Alternatively, to query the supported presentation modes for a surface combined with select other fixed swapchain creation parameters, call:

VkResult vkGetPhysicalDeviceSurfacePresentModes2EXT(
    VkPhysicalDevice physicalDevice,
    const VkPhysicalDeviceSurfaceInfo2KHR* pSurfaceInfo,
    uint32_t* pPresentModeCount,
    VkPresentModeKHR* pPresentModes);
  • physicalDevice is the physical device that will be associated with the swapchain to be created, as described for vkCreateSwapchainKHR.
  • pSurfaceInfo is a pointer to a VkPhysicalDeviceSurfaceInfo2KHR structure describing the surface and other fixed parameters that would be consumed by vkCreateSwapchainKHR.
  • pPresentModeCount is a pointer to an integer related to the number of presentation modes available or queried, as described below.
  • pPresentModes is either NULL or a pointer to an array of VkPresentModeKHR values, indicating the supported presentation modes.

vkGetPhysicalDeviceSurfacePresentModes2EXT behaves similarly to vkGetPhysicalDeviceSurfacePresentModesKHR, with the ability to specify extended inputs via chained input structures.

Valid Usage

VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06521

If the VK_GOOGLE_surfaceless_query extension is not enabled, pSurfaceInfo→surface must be a valid VkSurfaceKHR handle

VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-06522

If pSurfaceInfo→surface is not VK_NULL_HANDLE, pSurfaceInfo→surface must be supported by physicalDevice, as reported by vkGetPhysicalDeviceSurfaceSupportKHR or an equivalent platform-specific mechanism

Valid Usage (Implicit)

VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pPresentModeCount-parameter

pPresentModeCount must be a valid pointer to a uint32_t value

VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pPresentModes-parameter

If the value referenced by pPresentModeCount is not 0, and pPresentModes is not NULL, pPresentModes must be a valid pointer to an array of pPresentModeCount VkPresentModeKHR values