VkPhysicalDeviceFaultFeaturesKHR

The VkPhysicalDeviceFaultFeaturesKHR structure is defined as:

typedef struct VkPhysicalDeviceFaultFeaturesKHR {
    VkStructureType sType;
    void* pNext;
    VkBool32 deviceFault;
    VkBool32 deviceFaultVendorBinary;
    VkBool32 deviceFaultReportMasked;
    VkBool32 deviceFaultDeviceLostOnMasked;
} VkPhysicalDeviceFaultFeaturesKHR;

pub struct PhysicalDeviceFaultFeaturesKHR {
    s_type: vk::StructureType,
    p_next: *mut c_void,
    device_fault: vk::Bool32,
    device_fault_vendor_binary: vk::Bool32,
    device_fault_report_masked: vk::Bool32,
    device_fault_device_lost_on_masked: vk::Bool32,
}

This structure describes the following features:

• FEATURES DEVICEFAULT
  deviceFault indicates that the implementation supports the reporting of device fault information.
• FEATURES DEVICEFAULTVENDORBINARY
  deviceFaultVendorBinary indicates that the implementation supports the generation of vendor-specific binary crash dumps. These may provide additional information when imported into vendor-specific external tools.
• FEATURES DEVICEFAULTREPORTMASKED
  deviceFaultReportMasked indicates that the implementation supports masked faults in normal operation (ie. automatically recovered by the driver internally without the application receiving a VK_ERROR_DEVICE_LOST error) which may be reported via this extension even if they did not result in a VK_ERROR_DEVICE_LOST condition being returned to the application.
• FEATURES DEVICEFAULTDEVICELOSTONMASKED
  deviceFaultDeviceLostOnMasked indicates that the implementation supports returning VK_ERROR_DEVICE_LOST for faults that would be normally be masked.

In exceptional circumstances, some implementations may mask faults and attempt to recover from an error. In such circumstances, the device is not lost and further work can be submitted to the device. When such faults occur, the contents of all resources being written to at the time of the fault are undefined.

If the VkPhysicalDeviceFaultFeaturesKHR structure is included in the pNext chain of the VkPhysicalDeviceFeatures2 structure passed to vkGetPhysicalDeviceFeatures2, it is filled in to indicate whether each corresponding feature is supported. If the application wishes to use a VkDevice with any features described by VkPhysicalDeviceFaultFeaturesKHR, it must add an instance of the structure, with the desired feature members set to VK_TRUE, to the pNext chain of VkDeviceCreateInfo when creating the VkDevice.