Function Prototype

vkGetMemoryWin32HandlePropertiesKHR

Get Properties of External Memory Win32 Handles

Windows 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 vkGetMemoryWin32HandlePropertiesKHR(
    VkDevice device,
    VkExternalMemoryHandleTypeFlagBits handleType,
    HANDLE handle,
    VkMemoryWin32HandlePropertiesKHR* pMemoryWin32HandleProperties);
  • device is the logical device that will be importing handle.
  • handleType is a VkExternalMemoryHandleTypeFlagBits value specifying the type of the handle handle.
  • handle is the handle which will be imported.
  • pMemoryWin32HandleProperties is a pointer to a VkMemoryWin32HandlePropertiesKHR structure in which properties of handle are returned.

Valid Usage

VUID-vkGetMemoryWin32HandlePropertiesKHR-handle-00665

handle must point to a valid Windows memory handle

VUID-vkGetMemoryWin32HandlePropertiesKHR-handleType-00666

handleType must not be one of the handle types defined as opaque