DRED v1.2 supports PIX marker and event strings in Auto-Breadcrumbs



In Windows 10 1903, DRED 1.1 provided D3D12 developers with the ability to diagnose device removed events using GPU page fault data and automatic breadcrumbs. As a result, TDR debugging pain has been greatly reduced.  Hooray!  Unfortunately, developers still struggle to pinpoint which specific GPU workloads triggered the error.  So, we’ve made a few tweaks in DRED in the Windows 10 20H1 Release Preview.  Specifically, DRED 1.2 adds ‘Context Data’ to auto-breadcrumbs by integrating PIX marker and event strings into the auto-breadcrumb data.  With context data, developers can more precisely determine where a GPU fault occurred.  For example, instead of observing that a TDR occurs after the 71’st DrawInstanced call, the data can now indicate the fault occurred after the second DrawInstanced following the “BeginFoliage” PIX begin-event.

DRED 1.2 API’s

New D3D12 interfaces and data structures have been added to D3D12 to support DRED 1.2.


ID3D12DeviceRemovedExtendedDataSettings1 inherits from ID3D12DeviceRemovedExtendedDataSettings, adding a method for controlling DRED 1.2 breadcrumb context data.

ID3D12DeviceRemovedExtendedData1 inherits from ID3D12DeviceRemovedExtendedData, providing access to DRED 1.2 breadcrumb context data.



Points to the head of a linked list of D3D12_AUTO_BREADCRUMB_NODE1 structures.


Almost identical to D3D12_AUTO_BREADCRUMB_NODE with additional members describing DRED 1.2 breadcrumb context data.


Number of D3D12_DRED_BREADCRUMB_CONTEXT elements in the array pointed to by pBreadcrumbContexts.


Pointer to an array of D3D12_DRED_BREADCRUMB_CONTEXT  structures.


Provides access to the context string associated with a command list op breadcrumb.


Index of the command list operation in the command history of the associated command list.  The command history is the array pointed to by the pCommandHistory member of the D3D12_AUTO_BREADCRUMB_NODE1 structure.


Pointer to the null-terminated wide-character context string.

Accessing DRED 1.2 Context Data in Code

Use the ID3D12DeviceRemovedExtendedDataSettings1 interface to enable DRED before creating the device:

After a device removed event, use the ID3D12DeviceRemovedExtendedData1::GetAutoBreadcrumbsOutput1 method to access DRED 1.2 auto-breadcrumb data.

Post-mortem Debugging

The DRED data can be accessed in a user-mode debugger without requiring the application to log the DRED output.  To support this, we’ve implemented a DRED open-source debugger extension on GitHub.  This extension has been updated to support DRED 1.2 breadcrumb context data.

More details on how to use the debugger extension can be found in this README.md in the GitHub repositiory.

Force Enabling/Disabling DRED

Developers are no longer required to instrument application code to take advantage of DRED.  Instead, DRED can now be forced on or off using D3DConfig.exe.

D3DConfig.exe is a new console application in Windows 10 20H1 Release Preview that gives extended control over traditional DirectX Control Panel settings.  More details about D3DConfig can be found here.

To set an application to use d3dconfig/dxcpl settings use:

Note, this is identical to opening the DirectX Control panel and adding “myd3d12app.exe” to the executable list.

To view the current DRED settings use:

To force DRED page-faults on use:

It may be more useful to simply enable all DRED features:

The End of Mysterious TDR’s Forever?

No.  Unfortunately, there are still many device removal event bugs that DRED analysis may not help solve, including driver bugs or app bugs that can result in GPU errors in non-deterministic ways.  For example, hardware might prefetch from an invalid data-static descriptor, triggering device removal at some point before the first operation that accesses that descriptor.  While this would likely produce auto-breadcrumb results, the location of the error could be misleading.

We plan to continue making TDR debugging improvements.  As such, we would like to know if you’ve discovered a TDR-causing bug that was missed by the Debug Layer, GPU-Based Validation, PIX and DRED.



Leave a comment