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

# MapPagePriorityArray (família XBOX One)

> Mapeia páginas usando uma matriz de prioridade de páginas.

# Método XGMemoryLayout::MapPagePriorityArray (família XBOX One)

Mapeia páginas usando uma matriz de prioridade de páginas.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
HRESULT MapPagePriorityArray(
         XGMemoryLayoutMapping *pMapping,
         const UINT32 *pPagePriorityValues,
         UINT32 PagePriorityCount,
         UINT32 PageCount,
         UINT32 MaxEsramPageCount
)  
```

<a id="ID4EG" />

### Parâmetros

*pMapping*   \_Inout\_\
Tipo: XGMemoryLayoutMapping \*

\[in, out] O resultado do mapeamento atualizado como um ponteiro para uma estrutura [XGMemoryLayoutMapping](/pt-BR/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

*pPagePriorityValues*   \_In\_reads\_(PagePriorityCount)\
Tipo: UINT32\*

\[in] Os valores de prioridade na matriz de prioridade de páginas.

*PagePriorityCount*   \
Tipo: UINT32

O número de entradas de prioridade de página.

*PageCount*   \
Tipo: UINT32

O número total de páginas na matriz de prioridade de páginas, incluindo páginas do sistema e páginas ESRAM. Essa contagem ajustará o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

Se *PageCount* for XG\_ALL\_REMAINING\_PAGES, então [XGMemoryLayout::GetPageCountRemaining](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) é usado no lugar como o valor de *PageCount*.

*MaxEsramPageCount*\
Tipo: UINT32

O número máximo de páginas ESRAM na matriz de prioridade de páginas. Essa contagem ajustará o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

Se *MaxEsramPageCount* for XG\_ALL\_REMAINING\_PAGES, então [XGMemoryLayout::GetFreeEsramPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) é usado no lugar como o valor de *MaxEsramPageCount*.

<a id="ID4EP" />

### Valor retornado

Tipo: HRESULT

S\_OK, E\_INVALIDARG ou E\_OUTOFMEMORY.

<a id="remarks" />

## Comentários

Este método mapeia páginas usando uma matriz de prioridade de páginas. Cada valor na matriz de prioridade de páginas corresponde a uma página, organizada de acordo com o endereço virtual.

Os valores são definidos pelo usuário, e valores maiores indicam prioridade mais alta.

Antes de o mapeamento ser aplicado, a contagem máxima de páginas ESRAM é convertida em um valor mínimo de prioridade. Todos os valores de prioridade da matriz maiores ou iguais ao valor mínimo de prioridade são mapeados usando páginas ESRAM. A conversão de uma contagem máxima de páginas ESRAM em um valor mínimo de prioridade é uma operação O(*n* log *n*) sobre a contagem de páginas do mapeamento.

O mapeamento é criado com a contagem de páginas especificada e a contagem máxima de páginas ESRAM. Essas contagens ajustarão o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xgmemory.h

<a id="ID4EMD" />

**Plataformas compatíveis:** família XBOX One

## Confira também

[XGMemoryLayout](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Map](/pt-BR/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [XMemMapPhysicalPages](/pt-BR/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [XMemMapPhysicalPagesScatter](/pt-BR/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)
- [SetResidencyPriority](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_setresidencypriority_public.md)