> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# D3D12_AUTO_BREADCRUMB_NODE

> 將裝置移除擴充資料 (DRED) 自動階層連結資料表示為連結串列中的節點。

將裝置移除擴充資料 (DRED) 自動階層連結資料表示為連結串列中的節點。每個 **D3D12\_AUTO\_BREADCRUMB\_NODE** 物件都會透過其 `pNext` 成員單向連結到下一個節點；串列中的最後一個節點除外，其 `pNext` 會設為 `nullptr`。

Direct3D 12 執行階段會為每個圖形命令清單建立一個此類節點，並在與該清單相關聯的命令配置器中追蹤它們。執行命令清單時，會設定命令佇列資訊。偵測到裝置移除之後，Direct3D 12 執行階段會將任何仍未完成之 GPU 工作的自動階層連結節點連結在一起。

## 語法

```cpp theme={null}
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;
    UINT32  pLastBreadcrumbValue;
    D3D12_AUTO_BREADCRUMB_OP  pCommandHistory;
    struct D3D12_AUTO_BREADCRUMB_NODE  pNext;
} D3D12_AUTO_BREADCRUMB_NODE
```

### 成員

*pCommandListDebugNameA*\
類型：const char \*

指向未完成命令清單 (如果有的話) 之 ANSI 偵錯名稱的指標。

*pCommandListDebugNameW*\
類型：const wchar\_t \*

指向未完成命令清單 (如果有的話) 之寬字元偵錯名稱的指標。

*pCommandQueueDebugNameA*\
類型：const char \*

指向未完成命令佇列 (如果有的話) 之 ANSI 偵錯名稱的指標。

*pCommandQueueDebugNameW*\
類型：const wchar\_t \*

指向未完成命令佇列 (如果有的話) 之寬字元偵錯名稱的指標。

*pCommandList*\
類型：ID3D12GraphicsCommandList \*

指向 [ID3D12GraphicsCommandList 介面](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12GraphicsCommandList/id3d12graphicscommandlist_xs)的指標，代表執行當時未完成的命令清單。

*pCommandQueue*\
類型：ID3D12CommandQueue \*

指向 [ID3D12CommandQueue 介面](/zh-TW/reference/graphics/d3d12_xs/interfaces/ID3D12CommandQueue/id3d12commandqueue_xs)的指標，代表未完成的命令佇列。

*BreadcrumbCount*\
類型：UINT32

**UINT32**，包含 `pCommandHistory` 所指向之陣列中的 [D3D12\_AUTO\_BREADCRUMB\_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public) 值計數。

*pLastBreadcrumbValue*\
類型：UINT32 \*

指向常數 **UINT32** 的指標，其中包含 GPU 在執行相關聯命令清單時所完成之最後一個轉譯/計算作業的索引 (位於 `pCommandHistory` 所指向的陣列內)。

*pCommandHistory*\
類型：D3D12\_AUTO\_BREADCRUMB\_OP \*

指向 [D3D12\_AUTO\_BREADCRUMB\_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public) 值之常數陣列的指標，代表記錄到相關聯命令清單中的所有轉譯/計算作業。

*pNext*\
類型：struct D3D12\_AUTO\_BREADCRUMB\_NODE \*

指向常數 **D3D12\_AUTO\_BREADCRUMB\_NODE** 的指標，代表串列中的下一個自動階層連結節點；如果這是最後一個節點，則為 `nullptr`。

## 需求

**標頭:** d3d12\_xs.h 或 d3d12\_x.h\
**程式庫:** d3d12\_xs.lib 或 d3d12\_x.lib\
**支援的平台**: XBOX Series 主機與 XBOX One 系列

## 另請參閱

* [核心結構](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/direct3d-12-structures)
* [使用 DRED 診斷 GPU 錯誤](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/use-dred)


## Related topics

- [D3D12_DRED_AUTO_BREADCRUMBS_OUTPUT](/zh-TW/reference/graphics/d3d12/structs/d3d12_dred_auto_breadcrumbs_output_public.md)
- [D3D12_DEVICE_REMOVED_EXTENDED_DATA](/zh-TW/reference/graphics/d3d12/structs/d3d12_device_removed_extended_data_public.md)
- [D3D12_DEVICE_REMOVED_EXTENDED_DATA1](/zh-TW/reference/graphics/d3d12/structs/d3d12_device_removed_extended_data1_public.md)
- [D3D12_AUTO_BREADCRUMB_OP](/zh-TW/reference/graphics/d3d12/enums/d3d12_auto_breadcrumb_op_public.md)
- [D3D12_NODE_MASK](/zh-TW/reference/graphics/d3d12/structs/d3d12_node_mask_public.md)