Pular para o conteúdo principal
Registra um pool de páginas para que ele possa ser usado como origem para CopyPageMappingsX e funções semelhantes.

Sintaxe

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.

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.

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
CopyPageMappingsX
UnregisterPagePoolX
Última modificação em 6 de outubro de 2026