跳轉到主要內容
將裝置移除擴充資料 (DRED) 自動階層連結資料表示為連結串列中的節點。每個 D3D12_AUTO_BREADCRUMB_NODE 物件都會透過其 pNext 成員單向連結到下一個節點;串列中的最後一個節點除外,其 pNext 會設為 nullptr。 Direct3D 12 執行階段會為每個圖形命令清單建立一個此類節點,並在與該清單相關聯的命令配置器中追蹤它們。執行命令清單時,會設定命令佇列資訊。偵測到裝置移除之後,Direct3D 12 執行階段會將任何仍未完成之 GPU 工作的自動階層連結節點連結在一起。

語法

成員

pCommandListDebugNameA
類型:const char *
指向未完成命令清單 (如果有的話) 之 ANSI 偵錯名稱的指標。 pCommandListDebugNameW
類型:const wchar_t *
指向未完成命令清單 (如果有的話) 之寬字元偵錯名稱的指標。 pCommandQueueDebugNameA
類型:const char *
指向未完成命令佇列 (如果有的話) 之 ANSI 偵錯名稱的指標。 pCommandQueueDebugNameW
類型:const wchar_t *
指向未完成命令佇列 (如果有的話) 之寬字元偵錯名稱的指標。 pCommandList
類型:ID3D12GraphicsCommandList *
指向 ID3D12GraphicsCommandList 介面的指標,代表執行當時未完成的命令清單。 pCommandQueue
類型:ID3D12CommandQueue *
指向 ID3D12CommandQueue 介面的指標,代表未完成的命令佇列。 BreadcrumbCount
類型:UINT32
UINT32,包含 pCommandHistory 所指向之陣列中的 D3D12_AUTO_BREADCRUMB_OP 值計數。 pLastBreadcrumbValue
類型:UINT32 *
指向常數 UINT32 的指標,其中包含 GPU 在執行相關聯命令清單時所完成之最後一個轉譯/計算作業的索引 (位於 pCommandHistory 所指向的陣列內)。 pCommandHistory
類型:D3D12_AUTO_BREADCRUMB_OP *
指向 D3D12_AUTO_BREADCRUMB_OP 值之常數陣列的指標,代表記錄到相關聯命令清單中的所有轉譯/計算作業。 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 系列

另請參閱

最後修改於 2026年10月6日