VulkanHub
Function Prototype

vkGetMemoryHostPointerPropertiesEXT

Get properties of external memory host pointer

To determine the correct parameters to use when importing host pointers, call:

VkResult vkGetMemoryHostPointerPropertiesEXT(
    VkDevice device,
    VkExternalMemoryHandleTypeFlagBits handleType,
    const void* pHostPointer,
    VkMemoryHostPointerPropertiesEXT* pMemoryHostPointerProperties);
  • device is the logical device that will be importing pHostPointer.
  • handleType is a VkExternalMemoryHandleTypeFlagBits value specifying the type of the handle pHostPointer.
  • pHostPointer is the host pointer to import from.
  • pMemoryHostPointerProperties is a pointer to a VkMemoryHostPointerPropertiesEXT structure in which the host pointer properties are returned.

Valid Usage

VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01752

handleType must be VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT or VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT

VUID-vkGetMemoryHostPointerPropertiesEXT-pHostPointer-01753

pHostPointer must be a pointer aligned to an integer multiple of VkPhysicalDeviceExternalMemoryHostPropertiesEXT::minImportedHostPointerAlignment

VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01754

If handleType is VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_ALLOCATION_BIT_EXT, pHostPointer must be a pointer to host memory

VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-01755

If handleType is VK_EXTERNAL_MEMORY_HANDLE_TYPE_HOST_MAPPED_FOREIGN_MEMORY_BIT_EXT, pHostPointer must be a pointer to host mapped foreign memory

Valid Usage (Implicit)

VUID-vkGetMemoryHostPointerPropertiesEXT-device-parameter

device must be a valid VkDevice handle

VUID-vkGetMemoryHostPointerPropertiesEXT-handleType-parameter

handleType must be a valid VkExternalMemoryHandleTypeFlagBits value

VUID-vkGetMemoryHostPointerPropertiesEXT-pHostPointer-parameter

pHostPointer must be a pointer value

VUID-vkGetMemoryHostPointerPropertiesEXT-pMemoryHostPointerProperties-parameter

pMemoryHostPointerProperties must be a valid pointer to a VkMemoryHostPointerPropertiesEXT structure