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

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

[ID3D12Device3](/reference/graphics/d3d12_x/interfaces/id3d12device3/id3d12device3)


## Related topics

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