VkImportMetalIOSurfaceInfoEXT

To import, or create, a Metal IOSurfaceRef object to underlie a VkImage object, include a VkImportMetalIOSurfaceInfoEXT structure in the pNext chain of the VkImageCreateInfo structure in a vkCreateImage command.

The VkImportMetalIOSurfaceInfoEXT structure is defined as:

typedef struct VkImportMetalIOSurfaceInfoEXT {
    VkStructureType sType;
    const void* pNext;
    IOSurfaceRef ioSurface;
} VkImportMetalIOSurfaceInfoEXT;

• sType is a VkStructureType value identifying this structure.
• pNext is NULL or a pointer to a structure extending this structure.
• ioSurface is VK_NULL_HANDLE or the Metal IOSurfaceRef object that is to underlie the VkImage.

If ioSurface is not VK_NULL_HANDLE, it will be used to underlie the VkImage. If ioSurface is VK_NULL_HANDLE, the implementation will create a new IOSurface to underlie the VkImage.

If provided, the application must ensure that the configuration of the IOSurfaceRef object is compatible with the configuration of the VkImage. Failure to do so results in undefined: behavior.