vkGetInstanceProcAddr - Return a function pointer for a command

Function pointers for all Vulkan commandscan be obtained by calling:

• instance is the instance that the function pointer will becompatible with, orNULL for commands not dependent on any instance.

• pName is the name of the command to obtain.

vkGetInstanceProcAddr itself is obtained in a platform- and loader-specific manner.Typically, the loader library will export this command as a function symbol,so applicationscan link against the loader library, or load it dynamicallyand look up the symbol using platform-specific APIs.

The table below defines the various use cases forvkGetInstanceProcAddr and expected return value (“fp” is “functionpointer”) for each case.A valid returned function pointer (“fp”)must not beNULL.

The returned function pointer is of typePFN_vkVoidFunction, andmustbe cast to the type of the command being queried before use.

1

"*" means any representable value for the parameter (including validvalues, invalid values, andNULL).

2

The global commands are:vkEnumerateInstanceVersion,vkEnumerateInstanceExtensionProperties,vkEnumerateInstanceLayerProperties, andvkCreateInstance. Dispatchable commands are all other commands which are not global.

3

The returned function pointermust only be called with a dispatchableobject (the first parameter) that isinstance or a child ofinstance, e.g.VkInstance,VkPhysicalDevice,VkDevice,VkQueue, orVkCommandBuffer.

4

An “available device extension” is a device extension supported by anyphysical device enumerated byinstance.

5

Starting with Vulkan 1.2,vkGetInstanceProcAddr can resolve itself with aNULL instance pointer.

PFN_vkVoidFunction,VK_VERSION_1_0,VkInstance

For more information, see theVulkan Specification.

This page is extracted from the Vulkan Specification.Fixes and changes should be made to the Specification, not directly.