> ## 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 des pages à l'aide d'un modèle prédéfini passé sous forme de tableau d'octets.

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

<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 \*

Le résultat du mappage mis à jour, sous la forme d'un pointeur vers une structure [XGMemoryLayoutMapping](/fr-CA/reference/graphics/xgmemory_NR/structs/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](/fr-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/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](/fr-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) est substitué comme *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'ensemble 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-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr-CA/nda/nda-topic-directory.md)
- [Map](/fr-CA/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [XMemMapPhysicalPages](/fr-CA/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [ApuMapVirtualAddress](/fr-CA/reference/audio/apu/functions/apumapvirtualaddress.md)
- [ApuMapApuAddress](/fr-CA/reference/audio/apu/functions/apumapapuaddress.md)