Registered Extension Number

342

Revision

1

Extension and Version Dependencies

VK_KHR_get_physical_device_properties2

Contact

  • Ralph Potter r_potter

Extension Proposal

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

New Structures

New Enums

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 1, 2020-10-19 (Ralph Potter)

    • Initial revision

See Also

VkDeviceFaultAddressInfoEXT, VkDeviceFaultAddressTypeEXT, VkDeviceFaultCountsEXT, VkDeviceFaultInfoEXT, VkDeviceFaultVendorBinaryHeaderVersionEXT, VkDeviceFaultVendorBinaryHeaderVersionOneEXT, VkDeviceFaultVendorInfoEXT, VkPhysicalDeviceFaultFeaturesEXT, vkGetDeviceFaultInfoEXT

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.

Copyright

Copyright 2014-2023 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0