D3D12_AUTO_BREADCRUMB_NODE structure (d3d12.h)
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
typedef struct D3D12_AUTO_BREADCRUMB_NODE {
const char *pCommandListDebugNameA;
const wchar_t *pCommandListDebugNameW;
const char *pCommandQueueDebugNameA;
const wchar_t *pCommandQueueDebugNameW;
ID3D12GraphicsCommandList *pCommandList;
ID3D12CommandQueue *pCommandQueue;
UINT32 BreadcrumbCount;
const UINT32 *pLastBreadcrumbValue;
const D3D12_AUTO_BREADCRUMB_OP *pCommandHistory;
const D3D12_AUTO_BREADCRUMB_NODE *pNext;
struct D3D12_AUTO_BREADCRUMB_NODE;
} D3D12_AUTO_BREADCRUMB_NODE;
Members
pCommandListDebugNameA
A pointer to the ANSI debug name of the outstanding command list (if any).
pCommandListDebugNameW
A pointer to the wide debug name of the outstanding command list (if any).
pCommandQueueDebugNameA
A pointer to the ANSI debug name of the outstanding command queue (if any).
pCommandQueueDebugNameW
A pointer to the wide debug name of the outstanding command queue (if any).
pCommandList
A pointer to the ID3D12GraphicsCommandList interface representing the outstanding command list at the time of execution.
pCommandQueue
A pointer to the ID3D12CommandQueue interface representing the outstanding command queue.
BreadcrumbCount
A UINT32 containing the count of D3D12_AUTO_BREADCRUMB_OP values in the array pointed to by pCommandHistory
.
pLastBreadcrumbValue
A pointer to a constant UINT32 containing the number of pCommandHistory breadcrumbs ops completed. As such, the last successfully completed breadcrumb op is at index (*pLastBreadcrumbValue - 1)
in pCommandHistory.
pCommandHistory
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
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.
D3D12_AUTO_BREADCRUMB_NODE
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 10 Build 20348 |
Minimum supported server | Windows 10 Build 20348 |
Header | d3d12.h |