// Copyright (c) 2014-2016 Khronos Group. This work is licensed under a
// Creative Commons Attribution 4.0 International License; see
// http://creativecommons.org/licenses/by/4.0/

vkCreateInstance(3)
===================

Name
----
vkCreateInstance - Create a new Vulkan instance

C Specification
---------------

// refBegin vkCreateInstance Create a new Vulkan instance

To create an instance object, call:

include::../api/protos/vkCreateInstance.txt[]


Parameters
----------

  * pname:pCreateInfo points to an instance of slink:VkInstanceCreateInfo
    controlling creation of the instance.
  * pname:pAllocator controls host memory allocation as described in the
    <<memory-allocation, Memory Allocation>> chapter.
  * pname:pInstance points a sname:VkInstance handle in which the resulting
    instance is returned.


Description
-----------

fname:vkCreateInstance creates the instance, then enables and initializes
global layers and extensions requested by the application. If an extension
is provided by a layer, both the layer and extension must: be specified at
fname:vkCreateInstance time. If a specified layer cannot be found, no
sname:VkInstance will be created and the function will return
ename:VK_ERROR_LAYER_NOT_PRESENT. Likewise, if a specified extension cannot
be found the call will return ename:VK_ERROR_EXTENSION_NOT_PRESENT.

include::../validity/protos/vkCreateInstance.txt[]


See Also
--------

slink:VkAllocationCallbacks, slink:VkInstance, slink:VkInstanceCreateInfo


Document Notes
--------------

For more information, see the Vulkan Specification at URL

https://www.khronos.org/registry/vulkan/specs/1.0/xhtml/vkspec.html#vkCreateInstance

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

include::footer.txt[]