Skip to main content

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

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

​
Syntaxe

​
Paramètres

pMapping   _Inout_
Type : XGMemoryLayoutMapping * [in, out] Résultat du mappage mis à jour, sous forme de pointeur vers une structure 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 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 est utilisé comme valeur de MaxEsramPageCount.

​
Valeur de retour

Type : HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

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

​
Configuration requise

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

​
Voir aussi

XGMemoryLayout
Last modified on October 6, 2026