Function Prototype

vkGetDeviceFaultDebugInfoKHR

Retrieve vendor-specific crash dump data for the specified logical device

To retrieve a vendor-specific binary crash dump call:

VkResult vkGetDeviceFaultDebugInfoKHR(
    VkDevice device,
    VkDeviceFaultDebugInfoKHR* pDebugInfo);
  • device is the logical device from which to query the crash dump.
  • pDebugInfo is a pointer to a VkDeviceFaultDebugInfoKHR structure which will be populated with the vendor binary data crash dump binary, as described below.

If pDebugInfo→pVendorBinaryData is NULL, then the size of any vendor-specific binary crash dump is returned in pDebugInfo→vendorBinarySize.

If the pDebugInfo→pVendorBinaryData is not NULL then it must point to a buffer of size pDebugInfo→vendorBinarySize bytes.

On return, pDebugInfo→vendorBinarySize will be overwritten with the number of bytes actually written to the pDebugInfo→pVendorBinaryData.

If pDebugInfo→vendorBinaryData is not NULL, then subsequent calls to vkGetDeviceFaultDebugInfoKHR for the same device must return identical binary values in the pDebugInfo→pVendorBinaryData buffer up to the limit defined by pDebugInfo→vendorBinarySize.

If the vendor-specific crash dumps feature is not enabled, then implementations must set pDebugInfo->vendorBinarySize to zero and must not modify pDebugInfo->pVendorBinaryData.

Valid Usage (Implicit)