diff options
| author | Charles Giessen <46324611+charles-lunarg@users.noreply.github.com> | 2022-10-26 19:11:45 +0300 |
|---|---|---|
| committer | Charles Giessen <46324611+charles-lunarg@users.noreply.github.com> | 2022-10-26 19:29:53 +0300 |
| commit | 363c106d4d4a2cc6ce59bae51c1b99d93d5a08f6 (patch) | |
| tree | ec9c36b8cd6041f1e0008d7ac9657d66cf12e9f8 | |
| parent | 068e83f5f20e38c3ae1687e7f1aeb59bf6ce3e72 (diff) | |
Revert "Document vk_icdGetInstanceProcAddr querying device functions"
This reverts commit 068e83f5f20e38c3ae1687e7f1aeb59bf6ce3e72.
| -rw-r--r-- | docs/LoaderDriverInterface.md | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/LoaderDriverInterface.md b/docs/LoaderDriverInterface.md index ab20941ba..40430fbd8 100644 --- a/docs/LoaderDriverInterface.md +++ b/docs/LoaderDriverInterface.md @@ -35,7 +35,7 @@ - [Using Pre-Production ICDs or Software Drivers](#using-pre-production-icds-or-software-drivers) - [Driver Discovery on Android](#driver-discovery-on-android) - [Driver Manifest File Format](#driver-manifest-file-format) - - [Driver Manifest File Versions](#driver-manifest-file-versions) + - [Driver Manifest File Versions](#driver-manifest-file-versions) - [Driver Manifest File Version 1.0.0](#driver-manifest-file-version-100) - [Driver Manifest File Version 1.0.1](#driver-manifest-file-version-101) - [Driver Vulkan Entry Point Discovery](#driver-vulkan-entry-point-discovery) @@ -619,12 +619,8 @@ application. This field is optional. The Vulkan symbols exported by a driver must not clash with the loader's exported Vulkan symbols. -Therefore, `vk_icdGetInstanceProcAddr` was introduced to allow the loader -to perform the the same behavior as `vkGetInstanceProcAddr` but on a driver -basis. -As such, it behaves the same as `vkGetInstanceProcAddr`. -All drivers must export this function which is used for discovery of driver -Vulkan entry-points. +Because of this, all drivers must export the following function that is +used for discovery of driver Vulkan entry-points. This entry-point is not a part of the Vulkan API itself, only a private interface between the loader and drivers for version 1 and higher interfaces. @@ -636,11 +632,15 @@ VKAPI_ATTR PFN_vkVoidFunction VKAPI_CALL const char* pName); ``` -The driver must support querying global-level entry points by calling -`vk_icdGetInstanceProcAddr` with a NULL `VkInstance` parameter. +This function has very similar semantics to `vkGetInstanceProcAddr`. +`vk_icdGetInstanceProcAddr` returns valid function pointers for all the +global-level and instance-level Vulkan functions, and also for +`vkGetDeviceProcAddr`. Global-level functions are those which contain no dispatchable object as the first parameter, such as `vkCreateInstance` and `vkEnumerateInstanceExtensionProperties`. +The driver must support querying global-level entry points by calling +`vk_icdGetInstanceProcAddr` with a NULL `VkInstance` parameter. Instance-level functions are those that have either `VkInstance`, or `VkPhysicalDevice` as the first parameter dispatchable object. Both core entry points and any instance extension entry points the |