跳轉到主要內容
以非同步方式讓物件常駐於裝置。

語法

參數

Flags
類型:D3D12_RESIDENCY_FLAGS
控制當應用程式超過其記憶體預算時,是否應讓物件常駐。 NumObjects
類型:UINT
ppObjects 陣列中要常駐於裝置的物件數目。 ppObjects [in]
類型:ID3D12Pageable *const *
記憶體區塊的指標;包含物件的 ID3D12Pageable 介面指標陣列。 雖然大部分 D3D12 物件都繼承自 ID3D12Pageable,但只有下列項目支援常駐變更:
  • 描述元堆積
  • 堆積
  • 認可的資源
  • 查詢堆積
pFenceToSignal [in]
類型:ID3D12Fence *
工作完成時用來發出訊號之柵欄的指標。 FenceValueToSignal
類型:UINT64
工作完成時向柵欄發出訊號的不帶正負號 64 位元值。

傳回值

類型:HRESULT 此方法會傳回其中一個 Direct3D 12 傳回碼。

備註

EnqueueMakeResident 執行的動作與 MakeResident 相同,但不會等待資源成為常駐狀態。相反地,EnqueueMakeResident 會在工作完成時向柵欄發出訊號。 在柵欄發出訊號之前,系統不允許參考正透過 EnqueueMakeResident 成為常駐狀態之資源的工作。此外,對此 API 的呼叫保證會依序向其對應的柵欄發出訊號,因此每次呼叫都可以使用相同的柵欄。

需求

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

另請參閱

ID3D12Device ID3D12Device3
最後修改於 2026年10月6日