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

# RegisterPagePoolX (XBOX One 系列)

> 註冊分頁集區，使其可作為 CopyPageMappingsX 和類似函式的來源。

註冊分頁集區，使其可作為 **CopyPageMappingsX** 和類似函式的來源。

## 語法

```cpp theme={null}
HRESULT RegisterPagePoolX(  
         D3D12_GPU_VIRTUAL_ADDRESS PagePoolAddress,  
         UINT PagePoolPageCount,  
         HANDLE* pPagePoolHandle  
)  
```

### 參數

*PagePoolAddress*   \_In\_\
類型：D3D12\_GPU\_VIRTUAL\_ADDRESS

分頁集區的基底位址。此位址必須以 64KB 分頁對齊，且位於圖形記憶體 (MEM\_GRAPHICS) 中。

*PagePoolPageCount*   \_In\_\
類型：UINT

要在分頁集區中配置的分頁數目。此數目必須為非零，且範圍必須指定完全對應的記憶體：系統記憶體或 ESRAM。

*pPagePoolHandle*   \_Out\_\
類型：HANDLE\*

記憶體區塊的位址，在註冊成功時接收分頁集區的控制代碼。此控制代碼稍後可用來透過 [UnregisterPagePoolX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_unregisterpagepoolx) 取消註冊分頁集區。

### 傳回值

類型：HRESULT

如果記憶體不足以供分頁集區使用，則為 E\_OUTOFMEMORY。

如果引數無效，或任何引數為 [Direct3D 12 傳回碼](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues)，則為 E\_INVALIDARG。

## 備註

分頁集區註冊會鎖定集區中的實體分頁，使其在分頁集區取消對應之前不會被意外釋放。若嘗試使用未事先註冊的分頁集區，將會在 GPU 分頁對應函式期間造成錯誤。

分頁集區只需註冊一次即可建立集區；不需要重複註冊同一個分頁集區。

## 需求

**標頭：** d3d12\_x.h

**程式庫：** d3d12\_x.lib

**支援的平台：** XBOX One 系列

## 另請參閱

[ID3D12Device](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/id3d12device)\
[CopyPageMappingsX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copypagemappingsx)\
[UnregisterPagePoolX](/zh-TW/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_unregisterpagepoolx)


## Related topics

- [D3D12_MEMORY_POOL](/zh-TW/reference/graphics/d3d12/enums/d3d12_memory_pool_public.md)
- [IAudioStateMonitor::RegisterCallback 方法](/zh-TW/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [RegisterLampArrayStatusCallback 函式](/zh-TW/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [XPackageRegisterPackageInstalled](/zh-TW/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XTaskQueueRegisterWaiter](/zh-TW/reference/system/xtaskqueue/functions/xtaskqueueregisterwaiter.md)