C Specification
To query the image capabilities that are compatible with a
Linux DRM format modifier, set
VkPhysicalDeviceImageFormatInfo2::tiling
to
VK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT
and add
VkPhysicalDeviceImageDrmFormatModifierInfoEXT to the pNext
chain
of VkPhysicalDeviceImageFormatInfo2.
The VkPhysicalDeviceImageDrmFormatModifierInfoEXT structure is defined as:
typedef struct VkPhysicalDeviceImageDrmFormatModifierInfoEXT {
VkStructureType sType;
const void* pNext;
uint64_t drmFormatModifier;
VkSharingMode sharingMode;
uint32_t queueFamilyIndexCount;
const uint32_t* pQueueFamilyIndices;
} VkPhysicalDeviceImageDrmFormatModifierInfoEXT;
Members
-
sType
is the type of this structure. -
pNext
isNULL
or a pointer to an extension-specific structure. -
drmFormatModifier
is the image’s Linux DRM format modifier, corresponding to VkImageDrmFormatModifierExplicitCreateInfoEXT::modifier
or to VkImageDrmFormatModifierListCreateInfoEXT::pModifiers
. -
sharingMode
specifies how the image will be accessed by multiple queue families. -
queueFamilyIndexCount
is the number of entries in thepQueueFamilyIndices
array. -
pQueueFamilyIndices
is a list of queue families that will access the image (ignored ifsharingMode
is notVK_SHARING_MODE_CONCURRENT
).
Description
If the drmFormatModifier
is incompatible with the parameters specified
in VkPhysicalDeviceImageFormatInfo2 and its pNext
chain, then
vkGetPhysicalDeviceImageFormatProperties2 returns
VK_ERROR_FORMAT_NOT_SUPPORTED
.
The implementation must support the query of any drmFormatModifier
,
including unknown and invalid modifier values.
See Also
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 (c) 2014-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.