xrCreateVulkanInstanceKHR(3)

C Specification

// Provided by XR_KHR_vulkan_enable2
XrResult xrCreateVulkanInstanceKHR(
    XrInstance                                  instance,
    const XrVulkanInstanceCreateInfoKHR*        createInfo,
    VkInstance*                                 vulkanInstance,
    VkResult*                                   vulkanResult);

Parameters

Parameter Descriptions

instance is an XrInstance handle previously created with xrCreateInstance.
createInfo extensible input struct of type XrVulkanInstanceCreateInfoKHR
vulkanInstance points to a VkInstance handle to populate with the new Vulkan instance.
vulkanResult points to a VkResult to populate with the result of the vkCreateInstance operation as returned by XrVulkanInstanceCreateInfoKHR::pfnGetInstanceProcAddr.

Description

Valid Usage (Implicit)

The XR_KHR_vulkan_enable2 extension must be enabled prior to calling xrCreateVulkanInstanceKHR
instance must be a valid XrInstance handle
createInfo must be a pointer to a valid XrVulkanInstanceCreateInfoKHR structure
vulkanInstance must be a pointer to a VkInstance value
vulkanResult must be a pointer to a VkResult value

Return Codes

On success, this command returns

XR_SUCCESS

On failure, this command returns

XR_ERROR_FUNCTION_UNSUPPORTED
XR_ERROR_VALIDATION_FAILURE
XR_ERROR_RUNTIME_FAILURE
XR_ERROR_HANDLE_INVALID
XR_ERROR_INSTANCE_LOST
XR_ERROR_OUT_OF_MEMORY
XR_ERROR_LIMIT_REACHED
XR_ERROR_SYSTEM_INVALID

See Also

XR_KHR_vulkan_enable2, XrInstance, XrVulkanInstanceCreateInfoKHR, xrCreateVulkanDeviceKHR

Document Notes

For more information, see the OpenXR Specification

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

Copyright

Copyright 2014-2024, The Khronos Group Inc.

This work is licensed under a Creative Commons Attribution 4.0 International License.