Skip to main content

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

Mappe les pages à l’aide d’un modèle prédéfini transmis sous forme de tableau d’octets.

Syntaxe

Paramètres

pMapping   _Inout_
Type : XGMemoryLayoutMapping *
Résultat du mappage mis à jour, sous forme de pointeur vers une structure XGMemoryLayoutMapping. PageCount   
Type : UINT32
Nombre de pages avec lequel créer ce mappage, pages ESRAM et pages système comprises. Ce nombre ajuste la longueur du modèle et/ou l’utilisation de l’ESRAM. Si le modèle 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 de PageCount. pPattern   _In_reads_(PatternSizeBytes)
Type : BYTE*
Modèle prédéfini, sous forme de tableau d’octets. PatternSizeBytes   
Type : SIZE_T
Taille du modèle prédéfini. MaxEsramPageCount   
Type : UINT32
Nombre maximal de pages ESRAM avec lequel le mappage doit être créé. Ce nombre ajuste la longueur du modèle et/ou l’utilisation de l’ESRAM. Si le modèle 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 de MaxEsramPageCount.

Valeur de retour

Type : HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Remarques

Le mappage est créé avec un nombre de pages et un nombre maximal de pages ESRAM spécifiques. Ces nombres ajustent la longueur du modèle et/ou l’utilisation de l’ESRAM. Si le modèle 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