C Specification
To query additional capabilities specific to image types, call:
// Provided by VK_VERSION_1_1
VkResult vkGetPhysicalDeviceImageFormatProperties2(
VkPhysicalDevice physicalDevice,
const VkPhysicalDeviceImageFormatInfo2* pImageFormatInfo,
VkImageFormatProperties2* pImageFormatProperties);
or the equivalent command
// Provided by VK_KHR_get_physical_device_properties2
VkResult vkGetPhysicalDeviceImageFormatProperties2KHR(
VkPhysicalDevice physicalDevice,
const VkPhysicalDeviceImageFormatInfo2* pImageFormatInfo,
VkImageFormatProperties2* pImageFormatProperties);
Parameters
-
physicalDevice
is the physical device from which to query the image capabilities. -
pImageFormatInfo
is a pointer to a VkPhysicalDeviceImageFormatInfo2 structure describing the parameters that would be consumed by vkCreateImage. -
pImageFormatProperties
is a pointer to a VkImageFormatProperties2 structure in which capabilities are returned.
Description
vkGetPhysicalDeviceImageFormatProperties2
behaves similarly to
vkGetPhysicalDeviceImageFormatProperties, with the ability to return
extended information in a pNext
chain of output structures.
If the pNext
chain of pImageFormatInfo
includes a
VkVideoProfileListInfoKHR structure with a profileCount
member
greater than 0
, then this command returns format capabilities specific to
image types used in conjunction with the specified video
profiles.
In this case, this command will return one of the
video-profile-specific error codes if any of
the profiles specified via VkVideoProfileListInfoKHR::pProfiles
are not supported.
Furthermore, if VkPhysicalDeviceImageFormatInfo2::usage
includes
any image usage flag not supported by the specified video profiles, then
this command returns VK_ERROR_IMAGE_USAGE_NOT_SUPPORTED_KHR
.
If the hostImageCopy
feature is supported,
and:
-
pImageFormatInfo->usage
includesVK_IMAGE_USAGE_SAMPLED_BIT
-
pImageFormatInfo->flags
does not include either ofVK_IMAGE_CREATE_SPARSE_BINDING_BIT
,VK_IMAGE_CREATE_SPARSE_RESIDENCY_BIT
, orVK_IMAGE_CREATE_SPARSE_ALIASED_BIT
-
The
pNext
chain ofpImageFormatInfo
does not include a VkPhysicalDeviceExternalImageFormatInfo structure with non-zerohandleType
-
pImageFormatInfo->tiling
is notVK_IMAGE_TILING_DRM_FORMAT_MODIFIER_EXT
Then the result of calls to vkGetPhysicalDeviceImageFormatProperties2
with identical parameters except for the inclusion of
VK_IMAGE_USAGE_HOST_TRANSFER_BIT
in pImageFormatInfo->usage
must be identical.
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.