CopyPageMappingsX (família XBOX One)

​

Sintaxe

HRESULT CopyPageMappingsX(  
         D3D12_GPU_VIRTUAL_ADDRESS DestinationAddress,  
         UINT RangeCount,  
         const D3D12XBOX_PAGE_MAPPING_RANGE* pRanges,  
         D3D12_GPU_VIRTUAL_ADDRESS SourcePagePoolAddress,  
         UINT SourcePagePoolPageCount,  
         D3D12XBOX_PAGE_MAPPING_FLAGS Flags  
)  

​

Parâmetros

​

Valor retornado

​

Comentários

1. No momento da inicialização, prepare um “pool de páginas de origem”, que serve como origem das cópias de mapeamento de páginas.
   • Reserve um intervalo de memória virtual para o pool de páginas de origem usando XMemVirtualAlloc com MEM_64K_PAGES | MEM_RESERVE para o parâmetro AllocationType, junto com XMEM_GRAPHICS | XMEM_MAPPABLE para XMemFlags.
   • Se estiver usando páginas de memória do sistema, aloque páginas de memória do sistema usando XMemAllocatePhysicalPages.
   • Mapeie as páginas de memória do sistema para o intervalo de endereços reservado usando XMemMapPhysicalPages e/ou mapeie páginas ESRAM para o intervalo de endereços reservado usando D3DMapEsramMemory.
2. Para cada recurso cujos mapeamentos precisam ser atualizados em tempo de execução:
   1. Use a biblioteca XG para calcular o tamanho do recurso em páginas de 64 KB.
   2. Reserve um intervalo de memória virtual para o recurso usando XMemVirtualAlloc com MEM_64K_PAGES | MEM_RESERVE para o parâmetro AllocationType, junto com XMEM_GRAPHICS | XMEM_MAPPABLE para XMemFlags.
   3. Crie um objeto de API de recurso de posicionamento passando o endereço virtual reservado do recurso para CreatePlacedResourceX.
3. Em tempo de execução, quando os mapeamentos precisarem ser atualizados, chame CopyPageMappingsX na fila de comandos, copiando os mapeamentos do pool de páginas de origem para o intervalo de endereços reservado do recurso.

​

Requisitos

​

Confira também