Function Prototype

vkCreateHeadlessSurfaceEXT

Create a headless slink:VkSurfaceKHR object

To create a headless VkSurfaceKHR object, call:

VkResult vkCreateHeadlessSurfaceEXT(
    VkInstance instance,
    const VkHeadlessSurfaceCreateInfoEXT* pCreateInfo,
    const VkAllocationCallbacks* pAllocator,
    VkSurfaceKHR* pSurface);
  • instance is the instance to associate the surface with.
  • pCreateInfo is a pointer to a VkHeadlessSurfaceCreateInfoEXT structure containing parameters affecting the creation of the surface object.
  • pAllocator is the allocator used for host memory allocated for the surface object when there is no more specific allocator available (see Memory Allocation).
  • pSurface is a pointer to a VkSurfaceKHR handle in which the created surface object is returned.

Valid Usage (Implicit)

VUID-vkCreateHeadlessSurfaceEXT-pCreateInfo-parameter

pCreateInfo must be a valid pointer to a valid VkHeadlessSurfaceCreateInfoEXT structure

VUID-vkCreateHeadlessSurfaceEXT-pAllocator-parameter

If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure

VUID-vkCreateHeadlessSurfaceEXT-pSurface-parameter

pSurface must be a valid pointer to a VkSurfaceKHR handle