Function Prototype

vkUnmapMemory

Unmap a previously mapped memory object

To unmap a memory object once host access to it is no longer needed by the application, call:

void vkUnmapMemory(
    VkDevice device,
    VkDeviceMemory memory);
  • device is the logical device that owns the memory.
  • memory is the memory object to be unmapped.

Calling vkUnmapMemory is equivalent to calling vkUnmapMemory2KHR with an empty pNext chain and flags set to zero.

Valid Usage

VUID-vkUnmapMemory-memory-00689

memory must be currently host mapped

Valid Usage (Implicit)

VUID-vkUnmapMemory-device-parameter

device must be a valid VkDevice handle

VUID-vkUnmapMemory-memory-parent

memory must have been created, allocated, or retrieved from device

Host Synchronization

  • Host access to memory must be externally synchronized ::