> ## 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 (famille XBOX One)

> Mappe les pages à l'aide d'un tableau de priorités de page.

# Méthode XGMemoryLayout::MapPagePriorityArray (famille XBOX One)

Mappe les pages à l'aide d'un tableau de priorités de page.

<a id="syntaxSection" />

## Syntaxe

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

<a id="ID4EG" />

### Paramètres

*pMapping*   \_Inout\_\
Type : XGMemoryLayoutMapping \*

\[in, out] Résultat du mappage mis à jour, sous forme de pointeur vers une structure [XGMemoryLayoutMapping](/fr/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

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

\[in] Valeurs de priorité du tableau de priorités de page.

*PagePriorityCount*   \
Type : UINT32

Nombre d'entrées de priorité de page.

*PageCount*   \
Type : UINT32

Nombre total de pages du tableau de priorités de page, pages système et pages ESRAM comprises. Ce nombre ajuste la longueur du mappage et/ou l'utilisation de l'ESRAM. Si le tableau de valeurs de priorité de page n'est pas assez grand pour couvrir l'intégralité du mappage, des pages système sont utilisées pour compléter jusqu'à la fin du mappage.

Si *PageCount* a la valeur XG\_ALL\_REMAINING\_PAGES, [XGMemoryLayout::GetPageCountRemaining](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) est utilisé comme valeur de *PageCount*.

*MaxEsramPageCount*\
Type : UINT32

Nombre maximal de pages ESRAM du tableau de priorités de page. Ce nombre ajuste la longueur du mappage et/ou l'utilisation de l'ESRAM. Si le tableau de valeurs de priorité de page n'est pas assez grand pour couvrir l'intégralité du mappage, des pages système sont utilisées pour compléter jusqu'à la fin du mappage.

Si *MaxEsramPageCount* a la valeur XG\_ALL\_REMAINING\_PAGES, [XGMemoryLayout::GetFreeEsramPageCount](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) est utilisé comme valeur de *MaxEsramPageCount*.

<a id="ID4EP" />

### Valeur de retour

Type : HRESULT

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

<a id="remarks" />

## Remarques

Cette méthode mappe les pages à l'aide d'un tableau de priorités de page. Chaque valeur du tableau de priorités de page correspond à une page, classée selon l'adresse virtuelle.

Les valeurs sont définies par l'utilisateur ; plus la valeur est élevée, plus la priorité est haute.

Avant l'application du mappage, le nombre maximal de pages ESRAM est converti en une valeur de priorité minimale. Toutes les valeurs de priorité du tableau supérieures ou égales à la valeur de priorité minimale sont mappées à l'aide de pages ESRAM. La conversion d'un nombre maximal de pages ESRAM en valeur de priorité minimale est une opération en O(*n* log *n*) sur le nombre de pages du mappage.

Le mappage est créé avec le nombre de pages et le nombre maximal de pages ESRAM spécifiés. Ces nombres ajustent la longueur du mappage et/ou l'utilisation de l'ESRAM. Si le tableau de valeurs de priorité de page n'est pas assez grand pour couvrir l'intégralité du mappage, des pages système sont utilisées pour compléter jusqu'à la fin du mappage.

<a id="requirements" />

## Configuration requise

**En-tête :** xgmemory.h

<a id="ID4EMD" />

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[XGMemoryLayout](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Map](/fr/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [XMemMapPhysicalPages](/fr/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [XMemMapPhysicalPagesScatter](/fr/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)
- [SetResidencyPriority](/fr/reference/graphics/d3d12/interfaces/id3d12device1/methods/id3d12device1_setresidencypriority_public.md)