Structures

VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR

Structure describing whether the implementation provides unified image layouts

The VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR structure is defined as:

typedef struct VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR {
    VkStructureType sType;
    void* pNext;
    VkBool32 unifiedImageLayouts;
    VkBool32 unifiedImageLayoutsVideo;
} VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR;

This structure describes the following feature:

  • sType is a VkStructureType value identifying this structure.
  • pNext is NULL or a pointer to a structure extending this structure.
  • unifiedImageLayouts specifies whether usage of VK_IMAGE_LAYOUT_GENERAL, where valid, incurs no loss in efficiency. Additionally, it indicates whether it can be used in place of VK_IMAGE_LAYOUT_ATTACHMENT_FEEDBACK_LOOP_OPTIMAL_EXT.
  • unifiedImageLayoutsVideo specifies whether VK_IMAGE_LAYOUT_GENERAL can be used in place of any of the following image layouts with no loss in efficiency.
    • VK_IMAGE_LAYOUT_VIDEO_DECODE_DST_KHR
    • VK_IMAGE_LAYOUT_VIDEO_DECODE_SRC_KHR
    • VK_IMAGE_LAYOUT_VIDEO_DECODE_DPB_KHR
    • VK_IMAGE_LAYOUT_VIDEO_ENCODE_DST_KHR
    • VK_IMAGE_LAYOUT_VIDEO_ENCODE_SRC_KHR
    • VK_IMAGE_LAYOUT_VIDEO_ENCODE_DPB_KHR
    • VK_IMAGE_LAYOUT_VIDEO_ENCODE_QUANTIZATION_MAP_KHR

If the VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR structure is included in the pNext chain of the VkPhysicalDeviceFeatures2 structure passed to vkGetPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a VkDevice with any features described by VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR, it must add an instance of the structure, with the desired feature members set to VK_TRUE, to the pNext chain of VkDeviceCreateInfo when creating the VkDevice.

Valid Usage (Implicit)

VUID-VkPhysicalDeviceUnifiedImageLayoutsFeaturesKHR-sType-sType

sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_UNIFIED_IMAGE_LAYOUTS_FEATURES_KHR