Top Description Fields Constructors Methods
org.lwjgl.vulkan

public Class KHRGetPhysicalDeviceProperties2

extends Object
Class Inheritance
Imports
javax.annotation.*, java.nio.*, org.lwjgl.system.*
This extension provides new queries for device features, device properties, and format properties that can be easily extended by other extensions, without introducing any further queries. The Vulkan 1.0 feature/limit/formatproperty structures do not include sType/pNext members. This extension wraps them in new structures with sType/pNext members, so an application can query a chain of feature/limit/formatproperty structures by constructing the chain and letting the implementation fill them in. A new command is added for each vkGetPhysicalDevice* command in core Vulkan 1.0. The new feature structure (and a pNext chain of extending structures) can also be passed in to device creation to enable features.

This extension also allows applications to use the physical-device components of device extensions before CreateDevice is called.

Promotion to Vulkan 1.1

All functionality in this extension is included in core Vulkan 1.1, with the KHR suffix omitted. The original type, enum and command names are still available as aliases of the core functionality.

Examples

    // Get features with a hypothetical future extension.
    VkHypotheticalExtensionFeaturesKHR hypotheticalFeatures =
    {
        .sType = VK_STRUCTURE_TYPE_HYPOTHETICAL_FEATURES_KHR,
        .pNext = NULL,
    };

    VkPhysicalDeviceFeatures2KHR features =
    {
        .sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHR,
        .pNext = &hypotheticalFeatures,
    };

    // After this call, features and hypotheticalFeatures have been filled out.
    vkGetPhysicalDeviceFeatures2KHR(physicalDevice, &features);

    // Properties/limits can be chained and queried similarly.

    // Enable some features:
    VkHypotheticalExtensionFeaturesKHR enabledHypotheticalFeatures =
    {
        .sType = VK_STRUCTURE_TYPE_HYPOTHETICAL_FEATURES_KHR,
        .pNext = NULL,
    };

    VkPhysicalDeviceFeatures2KHR enabledFeatures =
    {
        .sType = VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHR,
        .pNext = &enabledHypotheticalFeatures,
    };

    enabledFeatures.features.xyz = VK_TRUE;
    enabledHypotheticalFeatures.abc = VK_TRUE;

    VkDeviceCreateInfo deviceCreateInfo =
    {
        .sType = VK_STRUCTURE_TYPE_DEVICE_CREATE_INFO,
        .pNext = &enabledFeatures,
        ...
        .pEnabledFeatures = NULL,
    };

    VkDevice device;
    vkCreateDevice(physicalDevice, &deviceCreateInfo, NULL, &device);
VK_KHR_get_physical_device_properties2
Name String
VK_KHR_get_physical_device_properties2
Extension Type
Instance extension
Registered Extension Number
60
Revision
2
Deprecation state
Contact
Other Extension Metadata
Last Modified Date
2017-09-05
IP Status
No known IP claims.
Interactions and External Dependencies
  • Promoted to Vulkan 1.1 Core
Contributors
  • Jeff Bolz, NVIDIA
  • Ian Elliott, Google

Field Summary

Modifier and TypeField and Description
public static final String
VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME

The extension name.

public static final int
VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_SPEC_VERSION

The extension specification version.

public static final int
VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2_KHR

Extends VkStructureType.

public static final int
VK_STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

Constructor Summary

AccessConstructor and Description
protected
KHRGetPhysicalDeviceProperties2()

Method Summary

Modifier and TypeMethod and Description
public static void
nvkGetPhysicalDeviceFeatures2KHR(VkPhysicalDevice physicalDevice, long pFeatures)

Unsafe version of: GetPhysicalDeviceFeatures2KHR

public static void
nvkGetPhysicalDeviceFormatProperties2KHR(VkPhysicalDevice physicalDevice, int format, long pFormatProperties)

Unsafe version of: GetPhysicalDeviceFormatProperties2KHR

public static int
nvkGetPhysicalDeviceImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, long pImageFormatInfo, long pImageFormatProperties)

Unsafe version of: GetPhysicalDeviceImageFormatProperties2KHR

public static void
nvkGetPhysicalDeviceMemoryProperties2KHR(VkPhysicalDevice physicalDevice, long pMemoryProperties)

Unsafe version of: GetPhysicalDeviceMemoryProperties2KHR

public static void
nvkGetPhysicalDeviceProperties2KHR(VkPhysicalDevice physicalDevice, long pProperties)

Unsafe version of: GetPhysicalDeviceProperties2KHR

public static void
nvkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice physicalDevice, long
a pointer to an integer related to the number of queue families available or queried, as described in GetPhysicalDeviceQueueFamilyProperties.
pQueueFamilyPropertyCount, long pQueueFamilyProperties)

Unsafe version of: GetPhysicalDeviceQueueFamilyProperties2KHR

public static void
nvkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, long pFormatInfo, long
a pointer to an integer related to the number of sparse format properties available or queried, as described below.
pPropertyCount, long pProperties)

Unsafe version of: GetPhysicalDeviceSparseImageFormatProperties2KHR

public static void
vkGetPhysicalDeviceFeatures2KHR(VkPhysicalDevice
the physical device from which to query the supported features.
physicalDevice, VkPhysicalDeviceFeatures2
a pointer to a VkPhysicalDeviceFeatures2 structure in which the physical device features are returned.
pFeatures)

See GetPhysicalDeviceFeatures2.

public static void
vkGetPhysicalDeviceFormatProperties2KHR(VkPhysicalDevice
the physical device from which to query the format properties.
physicalDevice, int
the format whose properties are queried.
format, VkFormatProperties2
a pointer to a VkFormatProperties2 structure in which physical device properties for format are returned.
pFormatProperties)

See GetPhysicalDeviceFormatProperties2.

public static int
vkGetPhysicalDeviceImageFormatProperties2KHR(VkPhysicalDevice
the physical device from which to query the image capabilities.
physicalDevice, VkPhysicalDeviceImageFormatInfo2
a pointer to a VkPhysicalDeviceImageFormatInfo2 structure describing the parameters that would be consumed by CreateImage.
pImageFormatInfo, VkImageFormatProperties2
a pointer to a VkImageFormatProperties2 structure in which capabilities are returned.
pImageFormatProperties)

See GetPhysicalDeviceImageFormatProperties2.

public static void
vkGetPhysicalDeviceMemoryProperties2KHR(VkPhysicalDevice
the handle to the device to query.
physicalDevice, VkPhysicalDeviceMemoryProperties2
a pointer to a VkPhysicalDeviceMemoryProperties2 structure in which the properties are returned.
pMemoryProperties)

See GetPhysicalDeviceMemoryProperties2.

public static void
vkGetPhysicalDeviceProperties2KHR(VkPhysicalDevice
the handle to the physical device whose properties will be queried.
physicalDevice, VkPhysicalDeviceProperties2
a pointer to a VkPhysicalDeviceProperties2 structure in which properties are returned.
pProperties)

See GetPhysicalDeviceProperties2.

public static void
vkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice
the handle to the physical device whose properties will be queried.
physicalDevice, IntBuffer
a pointer to an integer related to the number of queue families available or queried, as described in GetPhysicalDeviceQueueFamilyProperties.
pQueueFamilyPropertyCount, VkQueueFamilyProperties2.Buffer
either NULL or a pointer to an array of VkQueueFamilyProperties2 structures.
pQueueFamilyProperties)

See GetPhysicalDeviceQueueFamilyProperties2.

public static void
vkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice physicalDevice, int[] pQueueFamilyPropertyCount, VkQueueFamilyProperties2.Buffer pQueueFamilyProperties)

Array version of: GetPhysicalDeviceQueueFamilyProperties2KHR

public static void
vkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice
the physical device from which to query the sparse image format properties.
physicalDevice, VkPhysicalDeviceSparseImageFormatInfo2
a pointer to a VkPhysicalDeviceSparseImageFormatInfo2 structure containing input parameters to the command.
pFormatInfo, IntBuffer
a pointer to an integer related to the number of sparse format properties available or queried, as described below.
pPropertyCount, VkSparseImageFormatProperties2.Buffer
either NULL or a pointer to an array of VkSparseImageFormatProperties2 structures.
pProperties)

See GetPhysicalDeviceSparseImageFormatProperties2.

public static void
vkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceSparseImageFormatInfo2 pFormatInfo, int[] pPropertyCount, VkSparseImageFormatProperties2.Buffer pProperties)

Array version of: GetPhysicalDeviceSparseImageFormatProperties2KHR

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAMEback to summary
public static final String VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME

The extension name.

VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_SPEC_VERSIONback to summary
public static final int VK_KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_SPEC_VERSION

The extension specification version.

VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:
VK_STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2_KHRback to summary
public static final int VK_STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2_KHR

Extends VkStructureType.

Enum values:

Constructor Detail

KHRGetPhysicalDeviceProperties2back to summary
protected KHRGetPhysicalDeviceProperties2()

Method Detail

nvkGetPhysicalDeviceFeatures2KHRback to summary
public static void nvkGetPhysicalDeviceFeatures2KHR(VkPhysicalDevice physicalDevice, long pFeatures)

Unsafe version of: GetPhysicalDeviceFeatures2KHR

nvkGetPhysicalDeviceFormatProperties2KHRback to summary
public static void nvkGetPhysicalDeviceFormatProperties2KHR(VkPhysicalDevice physicalDevice, int format, long pFormatProperties)

Unsafe version of: GetPhysicalDeviceFormatProperties2KHR

nvkGetPhysicalDeviceImageFormatProperties2KHRback to summary
public static int nvkGetPhysicalDeviceImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, long pImageFormatInfo, long pImageFormatProperties)

Unsafe version of: GetPhysicalDeviceImageFormatProperties2KHR

nvkGetPhysicalDeviceMemoryProperties2KHRback to summary
public static void nvkGetPhysicalDeviceMemoryProperties2KHR(VkPhysicalDevice physicalDevice, long pMemoryProperties)

Unsafe version of: GetPhysicalDeviceMemoryProperties2KHR

nvkGetPhysicalDeviceProperties2KHRback to summary
public static void nvkGetPhysicalDeviceProperties2KHR(VkPhysicalDevice physicalDevice, long pProperties)

Unsafe version of: GetPhysicalDeviceProperties2KHR

nvkGetPhysicalDeviceQueueFamilyProperties2KHRback to summary
public static void nvkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice physicalDevice, long pQueueFamilyPropertyCount, long pQueueFamilyProperties)

Unsafe version of: GetPhysicalDeviceQueueFamilyProperties2KHR

Parameters
pQueueFamilyPropertyCount:long

a pointer to an integer related to the number of queue families available or queried, as described in GetPhysicalDeviceQueueFamilyProperties.

nvkGetPhysicalDeviceSparseImageFormatProperties2KHRback to summary
public static void nvkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, long pFormatInfo, long pPropertyCount, long pProperties)

Unsafe version of: GetPhysicalDeviceSparseImageFormatProperties2KHR

Parameters
pPropertyCount:long

a pointer to an integer related to the number of sparse format properties available or queried, as described below.

vkGetPhysicalDeviceFeatures2KHRback to summary
public static void vkGetPhysicalDeviceFeatures2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceFeatures2 pFeatures)

See GetPhysicalDeviceFeatures2.

Parameters
physicalDevice:VkPhysicalDevice

the physical device from which to query the supported features.

pFeatures:VkPhysicalDeviceFeatures2

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

vkGetPhysicalDeviceFormatProperties2KHRback to summary
public static void vkGetPhysicalDeviceFormatProperties2KHR(VkPhysicalDevice physicalDevice, int format, VkFormatProperties2 pFormatProperties)

See GetPhysicalDeviceFormatProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the physical device from which to query the format properties.

format:int

the format whose properties are queried.

pFormatProperties:VkFormatProperties2

a pointer to a VkFormatProperties2 structure in which physical device properties for format are returned.

vkGetPhysicalDeviceImageFormatProperties2KHRback to summary
public static int vkGetPhysicalDeviceImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceImageFormatInfo2 pImageFormatInfo, VkImageFormatProperties2 pImageFormatProperties)

See GetPhysicalDeviceImageFormatProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the physical device from which to query the image capabilities.

pImageFormatInfo:VkPhysicalDeviceImageFormatInfo2

a pointer to a VkPhysicalDeviceImageFormatInfo2 structure describing the parameters that would be consumed by CreateImage.

pImageFormatProperties:VkImageFormatProperties2

a pointer to a VkImageFormatProperties2 structure in which capabilities are returned.

Annotations
@NativeType:VkResult
vkGetPhysicalDeviceMemoryProperties2KHRback to summary
public static void vkGetPhysicalDeviceMemoryProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceMemoryProperties2 pMemoryProperties)

See GetPhysicalDeviceMemoryProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the handle to the device to query.

pMemoryProperties:VkPhysicalDeviceMemoryProperties2

a pointer to a VkPhysicalDeviceMemoryProperties2 structure in which the properties are returned.

vkGetPhysicalDeviceProperties2KHRback to summary
public static void vkGetPhysicalDeviceProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceProperties2 pProperties)

See GetPhysicalDeviceProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the handle to the physical device whose properties will be queried.

pProperties:VkPhysicalDeviceProperties2

a pointer to a VkPhysicalDeviceProperties2 structure in which properties are returned.

vkGetPhysicalDeviceQueueFamilyProperties2KHRback to summary
public static void vkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice physicalDevice, IntBuffer pQueueFamilyPropertyCount, VkQueueFamilyProperties2.Buffer pQueueFamilyProperties)

See GetPhysicalDeviceQueueFamilyProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the handle to the physical device whose properties will be queried.

pQueueFamilyPropertyCount:IntBuffer

a pointer to an integer related to the number of queue families available or queried, as described in GetPhysicalDeviceQueueFamilyProperties.

pQueueFamilyProperties:VkQueueFamilyProperties2.Buffer

either NULL or a pointer to an array of VkQueueFamilyProperties2 structures.

vkGetPhysicalDeviceQueueFamilyProperties2KHRback to summary
public static void vkGetPhysicalDeviceQueueFamilyProperties2KHR(VkPhysicalDevice physicalDevice, int[] pQueueFamilyPropertyCount, VkQueueFamilyProperties2.Buffer pQueueFamilyProperties)

Array version of: GetPhysicalDeviceQueueFamilyProperties2KHR

vkGetPhysicalDeviceSparseImageFormatProperties2KHRback to summary
public static void vkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceSparseImageFormatInfo2 pFormatInfo, IntBuffer pPropertyCount, VkSparseImageFormatProperties2.Buffer pProperties)

See GetPhysicalDeviceSparseImageFormatProperties2.

Parameters
physicalDevice:VkPhysicalDevice

the physical device from which to query the sparse image format properties.

pFormatInfo:VkPhysicalDeviceSparseImageFormatInfo2

a pointer to a VkPhysicalDeviceSparseImageFormatInfo2 structure containing input parameters to the command.

pPropertyCount:IntBuffer

a pointer to an integer related to the number of sparse format properties available or queried, as described below.

pProperties:VkSparseImageFormatProperties2.Buffer

either NULL or a pointer to an array of VkSparseImageFormatProperties2 structures.

vkGetPhysicalDeviceSparseImageFormatProperties2KHRback to summary
public static void vkGetPhysicalDeviceSparseImageFormatProperties2KHR(VkPhysicalDevice physicalDevice, VkPhysicalDeviceSparseImageFormatInfo2 pFormatInfo, int[] pPropertyCount, VkSparseImageFormatProperties2.Buffer pProperties)

Array version of: GetPhysicalDeviceSparseImageFormatProperties2KHR