> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MapFromPattern (famille XBOX One)

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

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

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT MapFromPattern(
         XGMemoryLayoutMapping *pMapping,
         UINT32 PageCount,
         const BYTE *pPattern,
         SIZE_T PatternSizeBytes,
         UINT32 MaxEsramPageCount
)  
```

<a id="ID4EG" />

### Paramètres

*pMapping*   \_Inout\_\
Type : XGMemoryLayoutMapping \*

Résultat du mappage mis à jour, sous forme de pointeur vers une structure [XGMemoryLayoutMapping](/fr/reference/graphics/xgmemory_NR/structs/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](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/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](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) est utilisé à la place de *MaxEsramPageCount*.

<a id="ID4EP" />

### Valeur de retour

Type : HRESULT

S\_OK, E\_INVALIDARG ou E\_OUTOFMEMORY.

<a id="remarks" />

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

<a id="requirements" />

## Configuration requise

**En-tête :** xgmemory.h

<a id="ID4E5C" />

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[XGMemoryLayout](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Map](/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Documentation de développement de jeux XBOX](/fr-CA/index.md)