VK_EXT_device_fault

Other Extension Metadata

Last Modified Date

2021-03-10

IP Status

No known IP claims.

Contributors

• Ralph Potter, Samsung
• Stuart Smith, AMD
• Jan-Harald Fredriksen, ARM
• Mark Bellamy, ARM
• Andrew Ellem, Google
• Alex Walters, IMG
• Jeff Bolz, NVIDIA
• Baldur Karlsson, Valve

Description

Device loss can be triggered by a variety of issues, including invalid API usage, implementation errors, or hardware failures.

This extension introduces a new command: vkGetDeviceFaultInfoEXT, which may be called subsequent to a VK_ERROR_DEVICE_LOST error code having been returned by the implementation. This command allows developers to query for additional information on GPU faults which may have caused device loss, and to generate binary crash dumps, which may be loaded into external tools for further diagnosis.

New Commands

• vkGetDeviceFaultInfoEXT

New Structures

• VkDeviceFaultAddressInfoEXT
• VkDeviceFaultCountsEXT
• VkDeviceFaultInfoEXT
• VkDeviceFaultVendorBinaryHeaderVersionOneEXT
• VkDeviceFaultVendorInfoEXT
• Extending VkPhysicalDeviceFeatures2, VkDeviceCreateInfo:
  • VkPhysicalDeviceFaultFeaturesEXT

New Enums

• VkDeviceFaultAddressTypeEXT
• VkDeviceFaultVendorBinaryHeaderVersionEXT

New Enum Constants

• VK_EXT_DEVICE_FAULT_EXTENSION_NAME
• VK_EXT_DEVICE_FAULT_SPEC_VERSION
• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_DEVICE_FAULT_COUNTS_EXT
  • VK_STRUCTURE_TYPE_DEVICE_FAULT_INFO_EXT
  • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FAULT_FEATURES_EXT

Version History

• Revision 2, 2023-04-05 (Ralph Potter)
  • Restored two missing members to the XML definition of VkDeviceFaultVendorBinaryHeaderVersionOneEXT. No functional change to the specification.
• Revision 1, 2020-10-19 (Ralph Potter)
  • Initial revision