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
.
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.