glfwGetInstanceProcAddress

Function glfwGetInstanceProcAddress 

Source
pub unsafe extern "C" fn glfwGetInstanceProcAddress(
    instance: *mut VkInstance_T,
    procname: *const i8,
) -> Option<unsafe extern "C" fn()>
Expand description

@brief Returns the address of the specified Vulkan instance function.

This function returns the address of the specified Vulkan core or extension function for the specified instance. If instance is set to NULL it can return any function exported from the Vulkan loader, including at least the following functions:

  • vkEnumerateInstanceExtensionProperties
  • vkEnumerateInstanceLayerProperties
  • vkCreateInstance
  • vkGetInstanceProcAddr

If Vulkan is not available on the machine, this function returns NULL and generates a @ref GLFW_API_UNAVAILABLE error. Call @ref glfwVulkanSupported to check whether Vulkan is at least minimally available.

This function is equivalent to calling vkGetInstanceProcAddr with a platform-specific query of the Vulkan loader as a fallback.

@param[in] instance The Vulkan instance to query, or NULL to retrieve functions related to instance creation. @param[in] procname The ASCII encoded name of the function. @return The address of the function, or NULL if an [error](@ref error_handling) occurred.

@errors Possible errors include @ref GLFW_NOT_INITIALIZED and @ref GLFW_API_UNAVAILABLE.

@pointer_lifetime The returned function pointer is valid until the library is terminated.

@thread_safety This function may be called from any thread.

@sa @ref vulkan_proc

@since Added in version 3.2.

@ingroup vulkan