Skip to main content
Represents Device Removed Extended Data (DRED) auto-breadcrumb data as a node in a linked list. Each D3D12_AUTO_BREADCRUMB_NODE object is singly linked to the next via its pNext member; except for the last node in the list, which has its pNext set to nullptr. The Direct3D 12 runtime creates one of these for each graphics command list, and tracks them in the command allocator associated with the list. When a command list is executed, the command queue information is set. After device removal is detected, the Direct3D 12 runtime links together the auto-breadcrumb nodes for any GPU work that is still outstanding.

Syntax

Members

pCommandListDebugNameA
Type: const char *
A pointer to the ANSI debug name of the outstanding command list (if any). pCommandListDebugNameW
Type: const wchar_t *
A pointer to the wide debug name of the outstanding command list (if any). pCommandQueueDebugNameA
Type: const char *
A pointer to the ANSI debug name of the outstanding command queue (if any). pCommandQueueDebugNameW
Type: const wchar_t *
A pointer to the wide debug name of the outstanding command queue (if any). pCommandList
Type: ID3D12GraphicsCommandList *
A pointer to the ID3D12GraphicsCommandList interface representing the outstanding command list at the time of execution. pCommandQueue
Type: ID3D12CommandQueue *
A pointer to the ID3D12CommandQueue interface representing the outstanding command queue. BreadcrumbCount
Type: UINT32
A UINT32 containing the count of D3D12_AUTO_BREADCRUMB_OP values in the array pointed to by pCommandHistory. pLastBreadcrumbValue
Type: UINT32 *
A pointer to a constant UINT32 containing the index (within the array pointed to by pCommandHistory) of the last render/compute operation that was completed by the GPU while executing the associated command list. pCommandHistory
Type: D3D12_AUTO_BREADCRUMB_OP *
A pointer to a constant array of D3D12_AUTO_BREADCRUMB_OP values representing all of the render/compute operations recorded into the associated command list. pNext
Type: struct D3D12_AUTO_BREADCRUMB_NODE *
A pointer to a constant D3D12_AUTO_BREADCRUMB_NODE representing the next auto-breadcrumb node in the list, or nullptr if this is the last node.

Requirements

Header: d3d12_xs.h or d3d12_x.h
Library: d3d12_xs.lib or d3d12_x.lib
Supported Platforms: XBOX Series consoles and XBOX One family

See Also

Last modified on August 20, 2026