vkGetPhysicalDeviceSurfacePresentModes2EXT
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 eitherNULL
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-physicalDevice-parameter
physicalDevice
must be a valid VkPhysicalDevice handle
VUID-vkGetPhysicalDeviceSurfacePresentModes2EXT-pSurfaceInfo-parameter
pSurfaceInfo
must be a valid pointer to a valid VkPhysicalDeviceSurfaceInfo2KHR structure
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