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 aVkSurfaceKHR
handle in which the created surface object is returned.
Valid Usage (Implicit)
VUID-vkCreateHeadlessSurfaceEXT-instance-parameter
instance
must be a valid VkInstance handle
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