VkImageStencilUsage2CreateInfoKHR

The VkImageStencilUsage2CreateInfoKHR structure is defined as:

typedef struct VkImageStencilUsage2CreateInfoKHR {
    VkStructureType sType;
    void* pNext;
    VkImageUsageFlags2KHR stencilUsage;
} VkImageStencilUsage2CreateInfoKHR;

pub struct ImageStencilUsage2CreateInfoKHR {
    s_type: vk::StructureType,
    p_next: *mut c_void,
    stencil_usage: vk::ImageUsageFlags2KHR,
}

• sType is a VkStructureType value identifying this structure.
• pNext is NULL or a pointer to a structure extending this structure.
• stencilUsage is a bitmask of VkImageUsageFlagBits2KHR describing the intended usage of the stencil aspect of the image.

If the pNext chain of VkImageCreateInfo includes a VkImageStencilUsage2CreateInfoKHR structure, then that structure includes the usage flags specific to the stencil aspect of the image for an image with a depth-stencil format.

This structure specifies image usages which only apply to the stencil aspect of a depth/stencil format image. When this structure is included in the pNext chain of VkImageCreateInfo, the stencil aspect of the image must only be used as specified by stencilUsage. Use of other aspects of an image are unaffected by this structure.

This structure can also be included in the pNext chain of VkPhysicalDeviceImageFormatInfo2 to query additional capabilities specific to image creation parameter combinations including a separate set of usage flags for the stencil aspect of the image using vkGetPhysicalDeviceImageFormatProperties2. When this structure is not included in the pNext chain of VkPhysicalDeviceImageFormatInfo2 then the implicit value of stencilUsage matches that of VkPhysicalDeviceImageFormatInfo2::usage.