Passer au contenu principal

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

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

Syntaxe

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. 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 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 est substitué comme valeur de MaxEsramPageCount.

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

Configuration requise

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

Voir aussi

XGMemoryLayout
Dernière modification le 6 octobre 2026