Function Prototype
vkTransitionImageLayout
Perform an image layout transition on the host
To perform an image layout transition on the host, call:
VkResult vkTransitionImageLayout(
VkDevice device,
uint32_t transitionCount,
const VkHostImageLayoutTransitionInfo* pTransitions);
pub fn transition_image_layout(
device: vk::Device,
transition_count: u32,
p_transitions: *const vk::HostImageLayoutTransitionInfo,
) -> vk::Result;
VkResult vkTransitionImageLayoutEXT(
VkDevice device,
uint32_t transitionCount,
const VkHostImageLayoutTransitionInfo* pTransitions);
pub fn transition_image_layout_ext(
device: vk::Device,
transition_count: u32,
p_transitions: *const vk::HostImageLayoutTransitionInfo,
) -> vk::Result;
deviceis the device which ownspTransitions[i].image.transitionCountis the number of image layout transitions to perform.pTransitionsis a pointer to an array of VkHostImageLayoutTransitionInfo structures specifying the image and subresource ranges within them to transition.
Valid Usage (Implicit)
VUID-vkTransitionImageLayout-device-parameter
device must be a valid VkDevice handle
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
Parent
VK_VERSION_1_4Type
Function Prototype
Return Values
VK_SUCCESS
VK_ERROR_INITIALIZATION_FAILED
VK_ERROR_OUT_OF_HOST_MEMORY
VK_ERROR_OUT_OF_DEVICE_MEMORY
VK_ERROR_MEMORY_MAP_FAILED
VK_ERROR_UNKNOWN
VK_ERROR_VALIDATION_FAILED