Safe Haskell | Safe-Inferred |
---|---|
Language | Haskell2010 |
Name
VK_KHR_get_physical_device_properties2 - instance extension
VK_KHR_get_physical_device_properties2
- Name String
VK_KHR_get_physical_device_properties2
- Extension Type
- Instance extension
- Registered Extension Number
- 60
- Revision
- 2
- Ratification Status
- Ratified
- Extension and Version Dependencies; Deprecation State
- Promoted to Vulkan 1.1
- 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
Description
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.
New Commands
getPhysicalDeviceFormatProperties2KHR
getPhysicalDeviceImageFormatProperties2KHR
getPhysicalDeviceMemoryProperties2KHR
getPhysicalDeviceProperties2KHR
getPhysicalDeviceQueueFamilyProperties2KHR
getPhysicalDeviceSparseImageFormatProperties2KHR
New Structures
ImageFormatProperties2KHR
PhysicalDeviceImageFormatInfo2KHR
PhysicalDeviceMemoryProperties2KHR
PhysicalDeviceProperties2KHR
PhysicalDeviceSparseImageFormatInfo2KHR
QueueFamilyProperties2KHR
SparseImageFormatProperties2KHR
Extending
DeviceCreateInfo
:
New Enum Constants
KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_SPEC_VERSION
Extending
StructureType
:STRUCTURE_TYPE_FORMAT_PROPERTIES_2_KHR
STRUCTURE_TYPE_IMAGE_FORMAT_PROPERTIES_2_KHR
STRUCTURE_TYPE_PHYSICAL_DEVICE_FEATURES_2_KHR
STRUCTURE_TYPE_PHYSICAL_DEVICE_IMAGE_FORMAT_INFO_2_KHR
STRUCTURE_TYPE_PHYSICAL_DEVICE_MEMORY_PROPERTIES_2_KHR
STRUCTURE_TYPE_PHYSICAL_DEVICE_PROPERTIES_2_KHR
STRUCTURE_TYPE_PHYSICAL_DEVICE_SPARSE_IMAGE_FORMAT_INFO_2_KHR
STRUCTURE_TYPE_QUEUE_FAMILY_PROPERTIES_2_KHR
STRUCTURE_TYPE_SPARSE_IMAGE_FORMAT_PROPERTIES_2_KHR
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);
Version History
Revision 1, 2016-09-12 (Jeff Bolz)
- Internal revisions
Revision 2, 2016-11-02 (Ian Elliott)
- Added ability for applications to use the physical-device components of device extensions before vkCreateDevice is called.
See Also
FormatProperties2KHR
, ImageFormatProperties2KHR
,
PhysicalDeviceFeatures2KHR
, PhysicalDeviceImageFormatInfo2KHR
,
PhysicalDeviceMemoryProperties2KHR
, PhysicalDeviceProperties2KHR
,
PhysicalDeviceSparseImageFormatInfo2KHR
, QueueFamilyProperties2KHR
,
SparseImageFormatProperties2KHR
, getPhysicalDeviceFeatures2KHR
,
getPhysicalDeviceFormatProperties2KHR
,
getPhysicalDeviceImageFormatProperties2KHR
,
getPhysicalDeviceMemoryProperties2KHR
,
getPhysicalDeviceProperties2KHR
,
getPhysicalDeviceQueueFamilyProperties2KHR
,
getPhysicalDeviceSparseImageFormatProperties2KHR
Document Notes
For more information, see the Vulkan Specification
This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.
Documentation
getPhysicalDeviceFeatures2KHR :: forall {a :: [Type]} {io}. (Extendss PhysicalDeviceFeatures2 a, PokeChain a, PeekChain a, MonadIO io) => PhysicalDevice -> io (PhysicalDeviceFeatures2 a) Source #
getPhysicalDeviceProperties2KHR :: forall {a :: [Type]} {io}. (Extendss PhysicalDeviceProperties2 a, PokeChain a, PeekChain a, MonadIO io) => PhysicalDevice -> io (PhysicalDeviceProperties2 a) Source #
getPhysicalDeviceFormatProperties2KHR :: forall {a :: [Type]} {io}. (Extendss FormatProperties2 a, PokeChain a, PeekChain a, MonadIO io) => PhysicalDevice -> Format -> io (FormatProperties2 a) Source #
getPhysicalDeviceImageFormatProperties2KHR :: forall {a :: [Type]} {b :: [Type]} {io}. (Extendss PhysicalDeviceImageFormatInfo2 a, Extendss ImageFormatProperties2 b, PokeChain a, PokeChain b, PeekChain b, MonadIO io) => PhysicalDevice -> PhysicalDeviceImageFormatInfo2 a -> io (ImageFormatProperties2 b) Source #
getPhysicalDeviceQueueFamilyProperties2KHR :: forall {a :: [Type]} {io}. (Extendss QueueFamilyProperties2 a, PokeChain a, PeekChain a, MonadIO io) => PhysicalDevice -> io ("queueFamilyProperties" ::: Vector (QueueFamilyProperties2 a)) Source #
getPhysicalDeviceMemoryProperties2KHR :: forall {a :: [Type]} {io}. (Extendss PhysicalDeviceMemoryProperties2 a, PokeChain a, PeekChain a, MonadIO io) => PhysicalDevice -> io (PhysicalDeviceMemoryProperties2 a) Source #
getPhysicalDeviceSparseImageFormatProperties2KHR :: MonadIO io => PhysicalDevice -> PhysicalDeviceSparseImageFormatInfo2 -> io ("properties" ::: Vector SparseImageFormatProperties2) Source #
pattern KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_SPEC_VERSION :: forall a. Integral a => a Source #
type KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME = "VK_KHR_get_physical_device_properties2" Source #
pattern KHR_GET_PHYSICAL_DEVICE_PROPERTIES_2_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #