Function Prototype

vkGetMemoryMetalHandlePropertiesEXT

Get Properties of External Memory Metal Handles

Metal memory handles compatible with Vulkan may also be created by non-Vulkan APIs using methods beyond the scope of this specification. To determine the correct parameters to use when importing such handles, call:

VkResult vkGetMemoryMetalHandlePropertiesEXT(
    VkDevice device,
    VkExternalMemoryHandleTypeFlagBits handleType,
    const void* pHandle,
    VkMemoryMetalHandlePropertiesEXT* pMemoryMetalHandleProperties);
  • device is the logical device that will be importing pHandle.
  • handleType is a VkExternalMemoryHandleTypeFlagBits value specifying the type of the handle pHandle.
  • pHandle is the handle which will be imported.
  • pMemoryMetalHandleProperties is a pointer to a VkMemoryMetalHandlePropertiesEXT structure in which properties of pHandle are returned.

Valid Usage

VUID-vkGetMemoryMetalHandlePropertiesEXT-handle-10416

pHandle must point to a valid id, id or id

VUID-vkGetMemoryMetalHandlePropertiesEXT-handleType-10417

handleType must be VK_EXTERNAL_MEMORY_HANDLE_TYPE_MTLBUFFER_BIT_EXT, VK_EXTERNAL_MEMORY_HANDLE_TYPE_MTLTEXTURE_BIT_EXT or VK_EXTERNAL_MEMORY_HANDLE_TYPE_MTLHEAP_BIT_EXT