Fix vk_icdGetPhysicalDeviceProcAddr docs
authorMark Young <marky@lunarg.com>
Thu, 17 Feb 2022 21:25:29 +0000 (14:25 -0700)
committerMark Young <marky@lunarg.com>
Fri, 18 Feb 2022 15:10:06 +0000 (08:10 -0700)
The language was not normative and also made clearer.

docs/LoaderDriverInterface.md

index 965993a1ec3a8a0b77ffde8566d8eb973e511a4a..7576822b953fa7850bbfef24e7d1087ca14c05b9 100644 (file)
@@ -703,12 +703,15 @@ In this way, it compares "pName" to every physical device function supported in
 the driver.
 
 The following rules apply:
-* If it is the name of a physical device function supported by the driver, the
-pointer to the driver's corresponding function should be returned.
-* If it is the name of a valid function which is **not** a physical device
-function (i.e. an instance, device, or other function implemented by the
-driver), then the value of `NULL` should be returned.
-* If the driver has no idea what this function is, it should return `NULL`.
+* If `pName` is the name of a Vulkan API entrypoint that takes a `VkPhysicalDevice`
+  as its primary dispatch handle, and the driver supports the entrypoint, then
+  the driver **must** return the valid function pointer to the driver's
+  implementation of that entrypoint.
+* If `pName` is the name of a Vulkan API entrypoint that takes something other than
+  a `VkPhysicalDevice` as its primary dispatch handle, then the driver **must**
+  return `NULL`.
+* If the driver is unaware of any entrypoint with the name `pName`, it **must**
+  return `NULL`.
 
 This support is optional and should not be considered a requirement.
 This is only required if a driver intends to support some functionality not