Passer au contenu principal

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

Mappe des pages à l’aide d’un tableau de jetons encodé par plages (run-length).

Syntaxe

Paramètres

pMapping   _Inout_
Type : XGMemoryLayoutMapping *
Le résultat du mappage mis à jour, sous la forme d’un pointeur vers une structure XGMemoryLayoutMapping. pTokens   _In_reads_(TokenCount)
Type : USHORT*
Le tableau de jetons encodé par plages. TokenCount   
Type : UINT32
Le nombre de jetons du tableau de jetons encodé par plages. Chaque jeton représente un bloc de pages ESRAM ou de pages système. PageCount   
Type : UINT32
Le nombre total de pages du tableau de jetons encodé par plages, y compris les pages système et les pages ESRAM. Ce nombre ajuste la longueur du tableau de plages décodé et/ou l’utilisation de l’ESRAM. Si le tableau de plages décodé 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 est utilisé à la place. MaxEsramPageCount
Type : UINT32
Le nombre maximal de pages ESRAM du tableau de jetons encodé par plages. Ce nombre ajuste la longueur du tableau de plages décodé et/ou l’utilisation de l’ESRAM. Si le tableau de plages décodé 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 est utilisé à la place.

Valeur de retour

Type : HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Remarques

Cette méthode mappe des pages à l’aide d’un tableau de jetons encodé par plages (run-length). 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 de plages décodé et/ou l’utilisation de l’ESRAM. Si le tableau de plages décodé 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.

Configuration requise

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

Voir aussi

XGMemoryLayout
Dernière modification le 6 octobre 2026