Function Prototype

vkCopyMemoryToImage

Copy data from host memory into an image

To copy data from host memory to an image object, call:

VkResult vkCopyMemoryToImageEXT(
    VkDevice device,
    const VkCopyMemoryToImageInfo*    pCopyMemoryToImageInfo);
  • device is the device which owns pCopyMemoryToImageInfo→dstImage.
  • pCopyMemoryToImageInfo is a pointer to a VkCopyMemoryToImageInfo structure describing the copy parameters.

This command is functionally similar to vkCmdCopyBufferToImage2, except it is executed on the host and reads from host memory instead of a buffer. The memory of pCopyMemoryToImageInfo→dstImage is accessed by the host as if coherent.

Because queue submissions automatically make host memory visible to the device, there would not be a need for a memory barrier before using the results of this copy operation on the device.

Valid Usage (Implicit)

VUID-vkCopyMemoryToImage-pCopyMemoryToImageInfo-parameter

pCopyMemoryToImageInfo must be a valid pointer to a valid VkCopyMemoryToImageInfo structure