## C Specification

The format properties of an Android hardware buffer can be obtained by including a VkAndroidHardwareBufferFormatProperties2ANDROID structure in the pNext chain of the VkAndroidHardwareBufferPropertiesANDROID structure passed to vkGetAndroidHardwareBufferPropertiesANDROID. This structure is defined as:

// Provided by VK_KHR_format_feature_flags2 with VK_ANDROID_external_memory_android_hardware_buffer
typedef struct VkAndroidHardwareBufferFormatProperties2ANDROID {
VkStructureType                  sType;
void*                            pNext;
VkFormat                         format;
uint64_t                         externalFormat;
VkFormatFeatureFlags2            formatFeatures;
VkComponentMapping               samplerYcbcrConversionComponents;
VkSamplerYcbcrModelConversion    suggestedYcbcrModel;
VkSamplerYcbcrRange              suggestedYcbcrRange;
VkChromaLocation                 suggestedXChromaOffset;
VkChromaLocation                 suggestedYChromaOffset;
} VkAndroidHardwareBufferFormatProperties2ANDROID;

## Members

• sType is the type of this structure.

• pNext is NULL or a pointer to a structure extending this structure.

• format is the Vulkan format corresponding to the Android hardware buffer’s format, or VK_FORMAT_UNDEFINED if there is not an equivalent Vulkan format.

• externalFormat is an implementation-defined external format identifier for use with VkExternalFormatANDROID. It must not be zero.

• formatFeatures describes the capabilities of this external format when used with an image bound to memory imported from buffer.

• samplerYcbcrConversionComponents is the component swizzle that should be used in VkSamplerYcbcrConversionCreateInfo.

• suggestedYcbcrModel is a suggested color model to use in the VkSamplerYcbcrConversionCreateInfo.

• suggestedYcbcrRange is a suggested numerical value range to use in VkSamplerYcbcrConversionCreateInfo.

• suggestedXChromaOffset is a suggested X chroma offset to use in VkSamplerYcbcrConversionCreateInfo.

• suggestedYChromaOffset is a suggested Y chroma offset to use in VkSamplerYcbcrConversionCreateInfo.

## Description

The bits reported in formatFeatures must include the bits reported in the corresponding fields of VkAndroidHardwareBufferFormatPropertiesANDROID::formatFeatures.

Valid Usage (Implicit)
• VUID-VkAndroidHardwareBufferFormatProperties2ANDROID-sType-sType
sType must be VK_STRUCTURE_TYPE_ANDROID_HARDWARE_BUFFER_FORMAT_PROPERTIES_2_ANDROID