跳轉到主要內容
表示要重複使用與命令配置器相關聯的記憶體。

語法

參數

傳回值

類型:HRESULT 如果有正在錄製的命令清單參考此命令配置器,此方法會傳回 E_FAIL。在此情況下,偵錯層也會發出錯誤。 如需其他可能的傳回值,請參閱 Direct3D 12 傳回碼。

備註

應用程式會呼叫 Reset 來重複使用與命令配置器相關聯的記憶體。透過這個 Reset 呼叫,執行階段和驅動程式會判定圖形處理器 (GPU) 已不再執行任何使用該命令配置器錄製命令的命令清單。 與 ID3D12GraphicsCommandList::Reset 不同,不建議在命令清單仍在執行時對命令配置器呼叫 Reset。 如果偵錯層無法證明沒有任何擱置中的 GPU 參考指向在此配置器中錄製命令的命令清單,就會發出警告。 如果多個執行緒同時 (在同一個配置器物件上) 呼叫 Reset,偵錯層會發出錯誤。

範例

D3D12HelloTriangle 範例使用 ID3D12CommandAllocator::Reset 的方式如下:
請參閱 D3D12 參考中的範例程式碼。

需求

標頭: d3d12_xs.h 或 d3d12_x.h
程式庫: d3d12_xs.lib 或 d3d12_x.lib
支援的平台:XBOX Series 主機和 XBOX One 系列主機

另請參閱

ID3D12CommandAllocator
最後修改於 2026年10月6日