From 34fe44521ca0efb8da41d223510d959e70d2cdd4 Mon Sep 17 00:00:00 2001 From: Karen Webb Date: Tue, 9 Jun 2026 23:01:18 +0100 Subject: [PATCH] Mark superseded VK_KHR_surface commands as legacy --- appendices/legacy.adoc | 19 +++++++++++++++++++ xml/vk.xml | 6 ++++++ 2 files changed, 25 insertions(+) diff --git a/appendices/legacy.adoc b/appendices/legacy.adoc index 58805b169..0002a63d4 100644 --- a/appendices/legacy.adoc +++ b/appendices/legacy.adoc @@ -98,6 +98,25 @@ provided in the pname:pNext chain of slink:VkDeviceCreateInfo instead of using slink:VkDeviceCreateInfo::pname:pEnabledFeatures. endif::VK_BASE_VERSION_1_1[] +ifdef::VK_KHR_get_surface_capabilities2[] +[[legacy-gpdsc2]] +=== Physical Device Surface Queries: Superseded via version 2 + +Some parts of apiext:VK_KHR_surface were superseded by +apiext:VK_KHR_get_surface_capabilities2, which introduced new versions +of some physical device surface query functions. +These provide the same functionality as the VK_KHR_surface functionality +but with greater extensibility. + +When querying surface capabilities, +flink:vkGetPhysicalDeviceSurfaceCapabilities2KHR should: be used instead of +flink:vkGetPhysicalDeviceSurfaceCapabilitiesKHR. + +When querying surface formats, +flink:vkGetPhysicalDeviceSurfaceFormats2KHR should: be used instead of +flink:vkGetPhysicalDeviceSurfaceFormatsKHR. +endif::VK_KHR_get_surface_capabilities2[] + ifndef::VKSC_VERSION_1_0[] // these were never included in VKSC 1.0 diff --git a/xml/vk.xml b/xml/vk.xml index bf86758ae..63e136711 100644 --- a/xml/vk.xml +++ b/xml/vk.xml @@ -23371,6 +23371,12 @@ endif::VK_KHR_internally_synchronized_queues[] + + + + + +