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

# MapRunLengthArray (famille XBOX One)

> Mappe les pages à l'aide d'un tableau RLE (run-length) de jetons.

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

Mappe les pages à l'aide d'un tableau RLE (run-length) de jetons.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT MapRunLengthArray(
         XGMemoryLayoutMapping *pMapping,
         const USHORT *pTokens,
         UINT32 TokenCount,
         UINT32 PageCount,
         UINT32 MaxEsramPageCount
)  
```

<a id="ID4EG" />

### Paramètres

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

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

*pTokens*   \_In\_reads\_(TokenCount)\
Type : USHORT\*

Tableau RLE de jetons.

*TokenCount*   \
Type : UINT32

Nombre de jetons du tableau RLE de jetons. Chaque jeton représente un bloc de pages ESRAM ou de pages système.

*PageCount*   \
Type : UINT32

Nombre total de pages du tableau RLE de jetons, pages système et pages ESRAM comprises. Ce nombre ajuste la longueur du tableau RLE décodé et/ou l'utilisation de l'ESRAM. Si le tableau RLE décodé 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é à la place.

*MaxEsramPageCount*\
Type : UINT32

Nombre maximal de pages ESRAM du tableau RLE de jetons. Ce nombre ajuste la longueur du tableau RLE décodé et/ou l'utilisation de l'ESRAM. Si le tableau RLE décodé 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é à la place.

<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 RLE de jetons. Chaque jeton représente un bloc de pages ESRAM ou de pages système ; pour plus de détails, consultez les macros #define **EsramToken** et **SystemToken** dans xgmemory.h.

Le mappage est créé avec un nombre de pages et un nombre maximal de pages ESRAM spécifiques. Ces nombres ajustent la longueur du tableau RLE décodé et/ou l'utilisation de l'ESRAM. Si le tableau RLE décodé 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="ID4EED" />

**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](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [XMemMapPhysicalPagesScatter](/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)
- [XblPresenceRichPresenceIds](/reference/live/xsapi-c/presence_c/structs/xblpresencerichpresenceids.md)
- [ILampArray::SetColorsForIndices method](/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_setcolorsforindices.md)