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

# SetResidencyPriority

> 此方法會設定指定物件清單的常駐優先順序。

此方法會設定指定物件清單的常駐優先順序。

## 語法

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

### 參數

*NumObjects*<br />類型：UINT

指定 <i>ppObjects</i> 和 <i>pPriorities</i> 陣列中的物件數目。

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

指定長度為 <i>NumObjects</i> 的陣列，其中包含 [ID3D12Pageable](/zh-TW/reference/graphics/d3d12/interfaces/id3d12pageable/id3d12pageable_public) 物件的參考。

*pPriorities \[in]*<br />類型：const D3D12\_RESIDENCY\_PRIORITY \*

為物件清單指定長度為 <i>NumObjects</i> 的 [D3D12\_RESIDENCY\_PRIORITY](/zh-TW/reference/graphics/d3d12/enums/d3d12_residency_priority_public) 值陣列。

### 傳回值

類型：HRESULT

此方法會傳回 HRESULT 成功或錯誤碼。

## 備註

如需詳細資訊，請參閱[常駐](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/residency)。

## 需求

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

## 另請參閱

[ID3D12Device1](/zh-TW/reference/graphics/d3d12/interfaces/id3d12device1/id3d12device1_public)


## Related topics

- [D3D12_RESIDENCY_PRIORITY](/zh-TW/reference/graphics/d3d12/enums/d3d12_residency_priority_public.md)
- [DSTORAGE_PRIORITY](/zh-TW/reference/system/dstorage/enums/dstorage_priority.md)
- [D3D12_RESIDENCY_FLAGS](/zh-TW/reference/graphics/d3d12/enums/d3d12_residency_flags_public.md)
- [DSTORAGE_PRIORITY_STATS](/zh-TW/reference/system/dstorage/structs/dstorage_priority_stats.md)
- [XAppCaptureMetadataPriority](/zh-TW/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)