> ## 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 (família XBOX One)

> Registra um pool de páginas para que ele possa ser usado como origem para CopyPageMappingsX e funções semelhantes.

Registra um pool de páginas para que ele possa ser usado como origem para **CopyPageMappingsX** e funções semelhantes.

## Sintaxe

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

### Parâmetros

*PagePoolAddress*   \_In\_\
Tipo: D3D12\_GPU\_VIRTUAL\_ADDRESS

O endereço base do pool de páginas. O endereço deve estar alinhado a páginas de 64 KB e na memória gráfica, MEM\_GRAPHICS.

*PagePoolPageCount*   \_In\_\
Tipo: UINT

O número de páginas a serem alocadas no pool de páginas. A contagem deve ser diferente de zero, e o intervalo deve especificar memória totalmente mapeada: memória do sistema ou ESRAM.

*pPagePoolHandle*   \_Out\_\
Tipo: HANDLE\*

O endereço de um bloco de memória que recebe o identificador do pool de páginas quando o registro é bem-sucedido. O identificador pode ser usado posteriormente para cancelar o registro do pool de páginas usando [UnregisterPagePoolX](/pt-BR/reference/graphics/d3d12_x/interfaces/id3d12device/methods/id3d12device_unregisterpagepoolx).

### Valor retornado

Tipo: HRESULT

E\_OUTOFMEMORY se não houver memória suficiente para o pool de páginas.

E\_INVALIDARG se os argumentos forem inválidos ou se algum deles for um dos [códigos de retorno do Direct3D 12](https://learn.microsoft.com/en-us/windows/desktop/direct3d12/d3d12-graphics-reference-returnvalues).

## Comentários

O registro do pool de páginas bloqueia as páginas físicas no pool para que elas não possam ser liberadas inadvertidamente até que o mapeamento do pool de páginas seja desfeito. Tentativas de usar um pool de páginas sem registrá-lo previamente causarão erros durante as funções de mapeamento de páginas da GPU.

Os pools de páginas precisam ser registrados apenas uma vez, para estabelecer o pool; registros repetidos do mesmo pool de páginas não são necessários.

## Requisitos

**Cabeçalho:** d3d12\_x.h

**Biblioteca:** d3d12\_x.lib

**Plataformas com suporte:** família XBOX One

## Confira também

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


## Related topics

- [D3D12_MEMORY_POOL](/pt-BR/reference/graphics/d3d12/enums/d3d12_memory_pool_public.md)
- [Método IAudioStateMonitor::RegisterCallback](/pt-BR/reference/audio/audiostatemonitor/interfaces/iaudiostatemonitor-registercallback.md)
- [Função RegisterLampArrayStatusCallback](/pt-BR/reference/lighting/lamparray/functions/registerlamparraystatuscallback.md)
- [XPackageRegisterPackageInstalled](/pt-BR/reference/system/xpackage/functions/xpackageregisterpackageinstalled.md)
- [XTaskQueueRegisterMonitor](/pt-BR/reference/system/xtaskqueue/functions/xtaskqueueregistermonitor.md)