Function Prototype

vkTransitionImageLayout

Perform an image layout transition on the host

To perform an image layout transition on the host, call:

VkResult vkTransitionImageLayoutEXT(
    VkDevice device,
    uint32_t transitionCount,
    const VkHostImageLayoutTransitionInfo*    pTransitions);
  • device is the device which owns pTransitions[i].image.
  • transitionCount is the number of image layout transitions to perform.
  • pTransitions is a pointer to an array of VkHostImageLayoutTransitionInfo structures specifying the image and subresource ranges within them to transition.

Valid Usage (Implicit)

VUID-vkTransitionImageLayout-pTransitions-parameter

pTransitions must be a valid pointer to an array of transitionCount valid VkHostImageLayoutTransitionInfo structures

VUID-vkTransitionImageLayout-transitionCount-arraylength

transitionCount must be greater than 0