> ## 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](/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public) 接口指针数组。

尽管大多数 D3D12 对象都继承自 [ID3D12Pageable](/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](/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](/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)


## Related topics

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