vkCopyMemoryToImage(3)
C Specification
To copy data from host memory to an image object, call:
// Provided by VK_VERSION_1_4VkResult vkCopyMemoryToImage( VkDevice device, const VkCopyMemoryToImageInfo* pCopyMemoryToImageInfo);// Provided by VK_EXT_host_image_copy// Equivalent to vkCopyMemoryToImageVkResult vkCopyMemoryToImageEXT( VkDevice device, const VkCopyMemoryToImageInfo* pCopyMemoryToImageInfo);Parameters
deviceis the device which ownspCopyMemoryToImageInfo->dstImage.pCopyMemoryToImageInfois a pointer to aVkCopyMemoryToImageInfo structure describing the copy parameters.
Description
This command is functionally similar tovkCmdCopyBufferToImage2,except it is executed on the host and reads from host memory instead of abuffer.The memory ofpCopyMemoryToImageInfo->dstImage is accessed by the hostas ifcoherent.
Because queue submissionsautomatically make host memory visible to the device, there would not be aneed for a memory barrier before using the results of this copy operation onthe device. |
VUID-vkCopyMemoryToImage-device-parameter
devicemust be a validVkDevice handleVUID-vkCopyMemoryToImage-pCopyMemoryToImageInfo-parameter
pCopyMemoryToImageInfomust be a valid pointer to a validVkCopyMemoryToImageInfo structure
Document Notes
For more information, see theVulkan Specification.
This page is extracted from the Vulkan Specification.Fixes and changes should be made to the Specification, not directly.