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

# Evict

> 啟用資料的分頁移出，這會使 GPU 無法存取該資料。

啟用資料的分頁移出，這會使 GPU 無法存取該資料。

## 語法

```cpp theme={null}
HRESULT Evict(
    UINT NumObjects,
    ID3D12Pageable const  ppObjects
)
```

### 參數

*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)，但只有下列物件支援常駐變更：描述元堆積、堆積、認可資源和查詢堆積

### 傳回值

類型：HRESULT

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

## 備註

**Evict** 會將與資源相關聯的資料保存到磁碟，然後從資源所在的記憶體集區中移除該資源。此方法應該在擁有實體記憶體的物件上呼叫：可以是認可資源 (擁有虛擬和實體記憶體指派) 或堆積；請注意，保留資源沒有實體記憶體，而放置資源則是從堆積借用記憶體。

請參閱 [MakeResident](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public) 的備註。

## 需求

**標頭：** 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)


## Related topics

- [MakeResident](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device/methods/id3d12device_makeresident_public.md)
- [D3D12_FEATURE_DATA_GPU_VIRTUAL_ADDRESS_SUPPORT](/zh-TW/reference/graphics/d3d12/structs/d3d12_feature_data_gpu_virtual_address_support_public.md)