vkGetPhysicalDeviceFeatures2 - Reports capabilities of a physical device

Parameters

• physicalDevice is the physical device from which to query the supported features.

• pFeatures is a pointer to a VkPhysicalDeviceFeatures2 structure in which the physical device features are returned.

Description

Each structure in pFeatures and its pNext chain contain members corresponding to fine-grained features. vkGetPhysicalDeviceFeatures2 writes each member to a boolean value indicating whether that feature is supported.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pFeatures must be a valid pointer to a VkPhysicalDeviceFeatures2 structure

See Also

VkPhysicalDevice, VkPhysicalDeviceFeatures2

vkGetPhysicalDeviceProperties2 - Returns properties of a physical device

Parameters

• physicalDevice is the handle to the physical device whose properties will be queried.

• pProperties points to an instance of the VkPhysicalDeviceProperties2 structure, that will be filled with returned information.

Description

Each structure in pProperties and its pNext chain contain members corresponding to properties or implementation-dependent limits. vkGetPhysicalDeviceProperties2 writes each member to a value indicating the value of that property or limit.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pProperties must be a valid pointer to a VkPhysicalDeviceProperties2 structure

See Also

VkPhysicalDevice, VkPhysicalDeviceProperties2

vkGetPhysicalDeviceFormatProperties2 - Lists physical device’s format capabilities

Parameters

• physicalDevice is the physical device from which to query the format properties.

• format is the format whose properties are queried.
• pFormatProperties is a pointer to a VkFormatProperties2 structure in which physical device properties for format are returned.

Description

vkGetPhysicalDeviceFormatProperties2 behaves similarly to vkGetPhysicalDeviceFormatProperties, with the ability to return extended information in a pNext chain of output structures.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• format must be a valid VkFormat value
• pFormatProperties must be a valid pointer to a VkFormatProperties2 structure

See Also

VkFormat, VkFormatProperties2, VkPhysicalDevice

vkGetPhysicalDeviceImageFormatProperties2 - Lists physical device’s image format capabilities

Parameters

• physicalDevice is the physical device from which to query the image capabilities.

• pImageFormatInfo points to an instance of the VkPhysicalDeviceImageFormatInfo2 structure, describing the parameters that would be consumed by vkCreateImage.
• pImageFormatProperties points to an instance of the 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.

Valid Usage

• If the pNext chain of pImageFormatProperties contains an instance of VkAndroidHardwareBufferUsageANDROID, the pNext chain of pImageFormatInfo must contain an instance of VkPhysicalDeviceExternalImageFormatInfo with handleType set to VK_EXTERNAL_MEMORY_HANDLE_TYPE_ANDROID_HARDWARE_BUFFER_BIT_ANDROID.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pImageFormatInfo must be a valid pointer to a valid VkPhysicalDeviceImageFormatInfo2 structure
• pImageFormatProperties must be a valid pointer to a VkImageFormatProperties2 structure

Return Codes

[Success] - VK_SUCCESS

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

• VK_ERROR_OUT_OF_DEVICE_MEMORY

• VK_ERROR_FORMAT_NOT_SUPPORTED

See Also

VkImageFormatProperties2, VkPhysicalDevice, VkPhysicalDeviceImageFormatInfo2

vkGetPhysicalDeviceQueueFamilyProperties2 - Reports properties of the queues of the specified physical device

Parameters

• physicalDevice is the handle to the physical device whose properties will be queried.

• pQueueFamilyPropertyCount is a pointer to an integer related to the number of queue families available or queried, as described in vkGetPhysicalDeviceQueueFamilyProperties.
• pQueueFamilyProperties is either NULL or a pointer to an array of VkQueueFamilyProperties2 structures.

Description

vkGetPhysicalDeviceQueueFamilyProperties2 behaves similarly to vkGetPhysicalDeviceQueueFamilyProperties, with the ability to return extended information in a pNext chain of output structures.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pQueueFamilyPropertyCount must be a valid pointer to a uint32_t value
• If the value referenced by pQueueFamilyPropertyCount is not 0, and pQueueFamilyProperties is not NULL, pQueueFamilyProperties must be a valid pointer to an array of pQueueFamilyPropertyCount VkQueueFamilyProperties2 structures

See Also

VkPhysicalDevice, VkQueueFamilyProperties2

vkGetPhysicalDeviceMemoryProperties2 - Reports memory information for the specified physical device

Parameters

• physicalDevice is the handle to the device to query.

• pMemoryProperties points to an instance of VkPhysicalDeviceMemoryProperties2 structure in which the properties are returned.

Description

vkGetPhysicalDeviceMemoryProperties2 behaves similarly to vkGetPhysicalDeviceMemoryProperties, with the ability to return extended information in a pNext chain of output structures.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pMemoryProperties must be a valid pointer to a VkPhysicalDeviceMemoryProperties2 structure

See Also

VkPhysicalDevice, VkPhysicalDeviceMemoryProperties2

vkGetPhysicalDeviceSparseImageFormatProperties2 - Retrieve properties of an image format applied to sparse images

Parameters

• physicalDevice is the physical device from which to query the sparse image capabilities.

• pFormatInfo is a pointer to a structure of type VkPhysicalDeviceSparseImageFormatInfo2 containing input parameters to the command.
• pPropertyCount is a pointer to an integer related to the number of sparse format properties available or queried, as described below.
• pProperties is either NULL or a pointer to an array of VkSparseImageFormatProperties2 structures.

Description

vkGetPhysicalDeviceSparseImageFormatProperties2 behaves identically to vkGetPhysicalDeviceSparseImageFormatProperties, with the ability to return extended information by adding extension structures to the pNext chain of its pProperties parameter.

Valid Usage (Implicit)

• physicalDevice must be a valid VkPhysicalDevice handle

• pFormatInfo must be a valid pointer to a valid VkPhysicalDeviceSparseImageFormatInfo2 structure
• pPropertyCount must be a valid pointer to a uint32_t value
• If the value referenced by pPropertyCount is not 0, and pProperties is not NULL, pProperties must be a valid pointer to an array of pPropertyCount VkSparseImageFormatProperties2 structures

See Also

VkPhysicalDevice, VkPhysicalDeviceSparseImageFormatInfo2, VkSparseImageFormatProperties2

VkPhysicalDeviceFeatures2 - Structure describing the fine-grained features that can be supported by an implementation

Members

The VkPhysicalDeviceFeatures2 structure is defined as:

Description

• sType is the type of this structure.

• pNext is NULL or a pointer to an extension-specific structure.
• features is a structure of type VkPhysicalDeviceFeatures describing the fine-grained features of the Vulkan 1.0 API.

The pNext chain of this structure is used to extend the structure with features defined by extensions. This structure can be used in vkGetPhysicalDeviceFeatures2 or can be in the pNext chain of a VkDeviceCreateInfo structure, in which case it controls which features are enabled in the device in lieu of pEnabledFeatures.

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2

See Also

VkPhysicalDeviceFeatures, VkStructureType, vkGetPhysicalDeviceFeatures2, vkGetPhysicalDeviceFeatures2KHR

VkPhysicalDeviceProperties2 - Structure specifying physical device properties

Description

The pNext chain of this structure is used to extend the structure with properties defined by extensions.

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkPhysicalDeviceBlendOperationAdvancedPropertiesEXT, VkPhysicalDeviceConservativeRasterizationPropertiesEXT, VkPhysicalDeviceDiscardRectanglePropertiesEXT, VkPhysicalDeviceExternalMemoryHostPropertiesEXT, VkPhysicalDeviceIDProperties, VkPhysicalDeviceMaintenance3Properties, VkPhysicalDeviceMultiviewPerViewAttributesPropertiesNVX, VkPhysicalDeviceMultiviewProperties, VkPhysicalDevicePointClippingProperties, VkPhysicalDeviceProtectedMemoryProperties, VkPhysicalDevicePushDescriptorPropertiesKHR, VkPhysicalDeviceSampleLocationsPropertiesEXT, VkPhysicalDeviceSamplerFilterMinmaxPropertiesEXT, VkPhysicalDeviceShaderCorePropertiesAMD, VkPhysicalDeviceSubgroupProperties, or VkPhysicalDeviceVertexAttributeDivisorPropertiesEXT
• Each sType member in the pNext chain must be unique

See Also

VkPhysicalDeviceProperties, VkStructureType, vkGetPhysicalDeviceProperties2, vkGetPhysicalDeviceProperties2KHR

VkFormatProperties2 - Structure specifying image format properties

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_2

• pNext must be NULL

See Also

VkFormatProperties, VkStructureType, vkGetPhysicalDeviceFormatProperties2, vkGetPhysicalDeviceFormatProperties2KHR

VkImageFormatProperties2 - Structure specifying a image format properties

Description

If the combination of parameters to vkGetPhysicalDeviceImageFormatProperties2 is not supported by the implementation for use in vkCreateImage, then all members of imageFormatProperties will be filled with zero.

Note

Filling imageFormatProperties with zero for unsupported formats is an exception to the usual rule that output structures have undefined contents on error. This exception was unintentional, but is preserved for backwards compatibility. This exeption only applies to imageFormatProperties, not sType, pNext, or any structures chained from pNext.

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2

• Each pNext member of any structure (including this one) in the pNext chain must be either NULL or a pointer to a valid instance of VkAndroidHardwareBufferUsageANDROID, VkExternalImageFormatProperties, VkSamplerYcbcrConversionImageFormatProperties, or VkTextureLODGatherFormatPropertiesAMD
• Each sType member in the pNext chain must be unique

See Also

VkImageFormatProperties, VkStructureType, vkGetPhysicalDeviceImageFormatProperties2, vkGetPhysicalDeviceImageFormatProperties2KHR

VkPhysicalDeviceImageFormatInfo2 - Structure specifying image creation parameters

Description

The members of VkPhysicalDeviceImageFormatInfo2 correspond to the arguments to vkGetPhysicalDeviceImageFormatProperties, with sType and pNext added for extensibility.

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2

• pNext must be NULL or a pointer to a valid instance of VkPhysicalDeviceExternalImageFormatInfo
• format must be a valid VkFormat value
• type must be a valid VkImageType value
• tiling must be a valid VkImageTiling value
• usage must be a valid combination of VkImageUsageFlagBits values
• usage must not be 0
• flags must be a valid combination of VkImageCreateFlagBits values

See Also

VkFormat, VkImageCreateFlags, VkImageTiling, VkImageType, VkImageUsageFlags, VkStructureType, vkGetPhysicalDeviceImageFormatProperties2, vkGetPhysicalDeviceImageFormatProperties2KHR

VkQueueFamilyProperties2 - Structure providing information about a queue family

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2

• pNext must be NULL

See Also

VkQueueFamilyProperties, VkStructureType, vkGetPhysicalDeviceQueueFamilyProperties2, vkGetPhysicalDeviceQueueFamilyProperties2KHR

VkPhysicalDeviceMemoryProperties2 - Structure specifying physical device memory properties

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2

• pNext must be NULL

See Also

VkPhysicalDeviceMemoryProperties, VkStructureType, vkGetPhysicalDeviceMemoryProperties2, vkGetPhysicalDeviceMemoryProperties2KHR

VkSparseImageFormatProperties2 - Structure specifying sparse image format properties

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2

• pNext must be NULL

See Also

VkSparseImageFormatProperties, VkStructureType, vkGetPhysicalDeviceSparseImageFormatProperties2, vkGetPhysicalDeviceSparseImageFormatProperties2KHR

VkPhysicalDeviceSparseImageFormatInfo2 - Structure specifying sparse image format inputs

Valid Usage

• samples must be a bit value that is set in VkImageFormatProperties::sampleCounts returned by vkGetPhysicalDeviceImageFormatProperties with format, type, tiling, and usage equal to those in this command and flags equal to the value that is set in VkImageCreateInfo::flags when the image is created

Valid Usage (Implicit)

• sType must be VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2

• pNext must be NULL
• format must be a valid VkFormat value
• type must be a valid VkImageType value
• samples must be a valid VkSampleCountFlagBits value
• usage must be a valid combination of VkImageUsageFlagBits values
• usage must not be 0
• tiling must be a valid VkImageTiling value

See Also

VkFormat, VkImageTiling, VkImageType, VkImageUsageFlags, VkSampleCountFlagBits, VkStructureType, vkGetPhysicalDeviceSparseImageFormatProperties2, vkGetPhysicalDeviceSparseImageFormatProperties2KHR