Passer au contenu principal

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

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

Syntaxe

Paramètres

pMapping   _Inout_
Type : XGMemoryLayoutMapping *
Le résultat du mappage mis à jour, sous la forme d’un pointeur vers une structure XGMemoryLayoutMapping. PageCount   
Type : UINT32
Le nombre de pages avec lesquelles créer ce mappage, y compris les pages ESRAM et les pages système. 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’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 PageCount. pPattern   _In_reads_(PatternSizeBytes)
Type : BYTE*
Le modèle prédéfini, sous forme de tableau d’octets. PatternSizeBytes   
Type : SIZE_T
La taille du modèle prédéfini. MaxEsramPageCount   
Type : UINT32
Le nombre maximal de pages ESRAM avec lesquelles 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’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 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’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