> ## 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 des pages à l'aide d'un tableau de priorités de page.

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

Mappe des 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] Le résultat du mappage mis à jour, sous la forme d'un pointeur vers une structure [XGMemoryLayoutMapping](/fr-CA/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

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

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

*PagePriorityCount*   \
Type : UINT32

Le nombre d'entrées de priorité de page.

*PageCount*   \
Type : UINT32

Le nombre total de pages du tableau de priorités de page, y compris les pages système et les pages ESRAM. 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'ensemble du mappage, des pages système sont utilisées pour compléter jusqu'à la fin du mappage.

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

*MaxEsramPageCount*\
Type : UINT32

Le 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'ensemble du mappage, des pages système sont utilisées pour compléter jusqu'à la fin du mappage.

Si *MaxEsramPageCount* est XG\_ALL\_REMAINING\_PAGES, [XGMemoryLayout::GetFreeEsramPageCount](/fr-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) est substitué 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 des pages à l'aide d'un tableau de priorités de page. Chaque valeur du tableau de priorités de page correspond à une page, organisée selon l'adresse virtuelle.

Les valeurs sont définies par l'utilisateur; les valeurs plus élevées indiquent une priorité plus élevée.

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 une valeur de priorité minimale est une opération 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'ensemble 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-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

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