VK_EXT_device_fault(3)

# VK_EXT_device_fault(3) Manual Page

## Name

VK_EXT_device_fault - device extension

Loading… please wait.

## Registered Extension Number

342

## Revision

2

## Ratification Status

Ratified

## Extension and Version Dependencies

VK_KHR_get_physical_device_properties2
or
Vulkan Version 1.1

## Deprecation State

- Promoted to VK_KHR_device_fault extension

## Contact

- Ralph Potter [GitLab]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

- 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 VkDeviceFaultAddressTypeKHR:

  - VK_DEVICE_FAULT_ADDRESS_TYPE_EXECUTE_INVALID_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_INSTRUCTION_POINTER_FAULT_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_INSTRUCTION_POINTER_INVALID_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_INSTRUCTION_POINTER_UNKNOWN_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_NONE_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_READ_INVALID_EXT

  - VK_DEVICE_FAULT_ADDRESS_TYPE_WRITE_INVALID_EXT

- 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

## See Also

No cross-references are available

## 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-2026 The Khronos Group Inc.

SPDX-License-Identifier: CC-BY-4.0