VK_KHR_device_fault

Other Extension Metadata

Last Modified Date

2026-03-18

IP Status

No known IP claims.

Contributors

• Ralph Potter, Samsung
• Craig Graham, Samsung
• Stuart Smith, AMD
• Jan-Harald Fredriksen, ARM
• Mark Bellamy, ARM
• Andrew Ellem, Google
• Alex Walters, IMG
• Jeff Bolz, NVIDIA
• Baldur Karlsson, Valve
• Adrian Ravai, Samsung
• Peter Gal, Samsung
• Matthew Netsch, QUALCOMM
• Tobias Hector, AMD
• Alan Harrison, AMD
• Vikram Tarikere, IMG
• Jon Leech, Khronos
• Samuel Pitoiset, Valve

Description

Device loss can be triggered by a variety of issues, including invalid API usage, implementation errors, or hardware failures. This extension introduces two new commands:

• vkGetDeviceFaultReportsKHR
• vkGetDeviceFaultDebugInfoKHR

vkGetDeviceFaultReportsKHR 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. Additionally this command allows developers to query for additional information on GPU faults which were internally recovered by the implementation.

vkGetDeviceFaultReportsKHR differs from vkGetDeviceFaultInfoEXT in that it can be called at any time, is able to report faults which do not result in VK_ERROR_DEVICE_LOST and allows the caller to wait for such an error to occur.

vkGetDeviceFaultDebugInfoKHR provides a separate interface which must only be called when a device loss has occurred to provide extended GPU vendor specific crash post-mortem information.

New Commands

• vkGetDeviceFaultDebugInfoKHR
• vkGetDeviceFaultReportsKHR

New Structures

• VkDeviceFaultAddressInfoKHR
• VkDeviceFaultDebugInfoKHR
• VkDeviceFaultInfoKHR
• VkDeviceFaultVendorBinaryHeaderVersionOneKHR
• VkDeviceFaultVendorInfoKHR
• Extending VkPhysicalDeviceFeatures2, VkDeviceCreateInfo:
  • VkPhysicalDeviceFaultFeaturesKHR
• Extending VkPhysicalDeviceProperties2:
  • VkPhysicalDeviceFaultPropertiesKHR

New Enums

• VkDeviceFaultAddressTypeKHR
• VkDeviceFaultFlagBitsKHR
• VkDeviceFaultVendorBinaryHeaderVersionKHR

New Bitmasks

• VkDeviceFaultFlagsKHR

New Enum Constants

• VK_KHR_DEVICE_FAULT_EXTENSION_NAME
• VK_KHR_DEVICE_FAULT_SPEC_VERSION
• Extending VkStructureType:
  • VK_STRUCTURE_TYPE_DEVICE_FAULT_DEBUG_INFO_KHR
  • VK_STRUCTURE_TYPE_DEVICE_FAULT_INFO_KHR
  • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FAULT_FEATURES_KHR
  • VK_STRUCTURE_TYPE_PHYSICAL_DEVICE_FAULT_PROPERTIES_KHR

Version History

• Revision 0, 2024-03-01 (Ralph Potter)
  • Internal Revision
• Revision 1, 2025-06-10 (Craig Graham)
  • Revised API to support async fault queries.