VkImageUsageFlags2CreateInfoKHR(3)

# VkImageUsageFlags2CreateInfoKHR(3) Manual Page

## Name

VkImageUsageFlags2CreateInfoKHR - Extended image usage flags

## C Specification

The `VkImageUsageFlags2CreateInfoKHR` structure is defined as:

    // Provided by VK_KHR_extended_flags
    typedef struct VkImageUsageFlags2CreateInfoKHR {
        VkStructureType          sType;
        void*                    pNext;
        VkImageUsageFlags2KHR    usage;
    } VkImageUsageFlags2CreateInfoKHR;

## Members

- `sType` is a VkStructureType value identifying this structure.

- `pNext` is `NULL` or a pointer to a structure extending this structure.

- `usage` is a bitmask of VkImageUsageFlagBits2KHR specifying allowed usages of the image.

## Description

If this structure is included in the `pNext` chain of an image creation structure, `usage` is used instead of the corresponding `usage` value passed in that creation structure, allowing additional usage flags to be specified.

If this structure is included in the `pNext` chain of a query structure including VkImageCreateFlags, the usage flags of the image are returned in `flags` of this structure, allowing additional usage flags to be queried. The flags representable in VkImageUsageFlags are still returned in the query structure in this case.

Valid Usage (Implicit)

- VUID-VkImageUsageFlags2CreateInfoKHR-sType-sType
  `sType` must be VK_STRUCTURE_TYPE_IMAGE_USAGE_FLAGS_2_CREATE_INFO_KHR

- VUID-VkImageUsageFlags2CreateInfoKHR-usage-parameter
  `usage` must be a valid combination of VkImageUsageFlagBits2KHR values

- VUID-VkImageUsageFlags2CreateInfoKHR-usage-requiredbitmask
  `usage` must not be `0`

Structure Chaining

Extends the structures

  - VkFramebufferAttachmentImageInfo

  - VkImageCreateInfo

  - VkPhysicalDeviceImageFormatInfo2

  - VkPhysicalDeviceSparseImageFormatInfo2

  - VkPhysicalDeviceVideoFormatInfoKHR

  - VkSurfaceCapabilities2KHR

  - VkSwapchainCreateInfoKHR

  - VkVideoFormatPropertiesKHR

## See Also

VK_KHR_extended_flags, VkImageUsageFlags2KHR, VkStructureType

## Document Notes

For more information, see the Vulkan Specification.

This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.

## Copyright

Copyright 2014-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0