> ## 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.

# EnqueueMakeResident

> 以非同步方式讓物件常駐於裝置。

以非同步方式讓物件常駐於裝置。

## 語法

```cpp theme={null}
HRESULT EnqueueMakeResident(
    D3D12_RESIDENCY_FLAGS Flags,
    UINT NumObjects,
    ID3D12Pageable const  ppObjects,
    ID3D12Fence  pFenceToSignal,
    UINT64 FenceValueToSignal
)
```

### 參數

*Flags*<br />類型：D3D12\_RESIDENCY\_FLAGS

控制當應用程式超過其記憶體預算時，是否應讓物件常駐。

*NumObjects*<br />類型：UINT

<i>ppObjects</i> 陣列中要常駐於裝置的物件數目。

*ppObjects \[in]*<br />類型：ID3D12Pageable \*const \*

記憶體區塊的指標；包含物件的 [ID3D12Pageable](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public) 介面指標陣列。

雖然大部分 D3D12 物件都繼承自 [ID3D12Pageable](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public)，但只有下列項目支援常駐變更：

<ul>
  <li>描述元堆積</li>
  <li>堆積</li>
  <li>認可的資源</li>
  <li>查詢堆積</li>
</ul>

*pFenceToSignal \[in]*<br />類型：ID3D12Fence \*

工作完成時用來發出訊號之柵欄的指標。

*FenceValueToSignal*<br />類型：UINT64

工作完成時向柵欄發出訊號的不帶正負號 64 位元值。

### 傳回值

類型：HRESULT

此方法會傳回其中一個 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)。

## 備註

**EnqueueMakeResident** 執行的動作與 [MakeResident](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public) 相同，但不會等待資源成為常駐狀態。相反地，**EnqueueMakeResident** 會在工作完成時向柵欄發出訊號。

在柵欄發出訊號之前，系統不允許參考正透過 **EnqueueMakeResident** 成為常駐狀態之資源的工作。此外，對此 API 的呼叫保證會依序向其對應的柵欄發出訊號，因此每次呼叫都可以使用相同的柵欄。

## 需求

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

## 另請參閱

[ID3D12Device](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)

[ID3D12Device3](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

- [D3D12_RESIDENCY_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_residency_flags_public.md)
- [MakeResident](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public.md)
- [ID3D12Pageable](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public.md)
- [XApuEnqueueCommand](/zh-TW/reference/audio/xapu/functions/xapuenqueuecommand.md)
- [IDStorageQueueX::EnqueueRequest](/zh-TW/reference/system/dstorage/interfaces/IDStorageQueueX/methods/idstoragequeuex_enqueuerequest.md)