Skip to main content

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

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

Syntaxe

Paramètres

pMapping   _Inout_
Type : XGMemoryLayoutMapping *
Résultat du mappage mis à jour, sous forme de pointeur vers une structure 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 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 est utilisé à la place.

Valeur de retour

Type : HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

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.

Configuration requise

En-tête : xgmemory.h Plateformes prises en charge : famille XBOX One

Voir aussi

XGMemoryLayout
Last modified on October 6, 2026