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
-
physicalDeviceis the physical device from which to query the image capabilities. -
pImageFormatInfois a pointer to a VkPhysicalDeviceImageFormatInfo2 structure describing the parameters that would be consumed by vkCreateImage. -
pImageFormatPropertiesis 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
VkVideoProfilesKHR structure with a profileCount member greater
than 0, then vkGetPhysicalDeviceImageFormatProperties2 returns
format capabilities specific to image types used in conjunction with the
specified video codec operations and corresponding video profiles.
In this case vkGetPhysicalDeviceImageFormatProperties2 returns one of
the video-profile-specific error codes if any
of the profiles specified via VkVideoProfilesKHR::pProfiles are
not supported.
Furthermore, if VkPhysicalDeviceImageFormatInfo2::usage includes
any image usage flags not supported by the specified video profiles then
vkGetPhysicalDeviceImageFormatProperties2 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.