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

# CreateMapping (famille XBOX One)

> Crée un nouveau mappage portant le nom spécifié.

# Méthode XGMemoryLayout::CreateMapping (famille XBOX One)

Crée un nouveau mappage portant le nom spécifié.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT CreateMapping(
         const WCHAR *strName,
         XGMemoryLayoutMapping *pMapping,
         UINT32 AlignmentBytes= 0  
)  
```

<a id="ID4EG" />

### Paramètres

*strName*   \_In\_z\_\
Type : WCHAR\*

Nom du nouveau mappage.

*pMapping*   \_Out\_\
Type : XGMemoryLayoutMapping \*

Nouveau mappage, sous forme de pointeur vers une structure [XGMemoryLayoutMapping](/fr/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

*AlignmentBytes*   \_In\_\
Type : UINT32

Alignement de l'adresse virtuelle du mappage, en octets. Spécifiez 0 pour utiliser l'alignement par défaut `XG_GPU_PAGE_SIZE_BYTES`.

<a id="ID4EP" />

### Valeur de retour

Type : HRESULT

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

<a id="remarks" />

## Remarques

Crée un nouveau mappage portant le nom donné. Définissez AlignmentBytes sur 0 pour utiliser l'alignement par défaut, `XG_GPU_PAGE_SIZE_BYTES`, pour l'alignement de l'adresse virtuelle du mappage.

Cette constante représente la taille, en octets, d'une page GPU XG.

Cette taille est généralement de 64 Ko, ce que vous pouvez vérifier à l'aide de la méthode [XGMemoryLayout::GetPageSizeBytes](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagesizebytes).

Le nouveau mappage est créé sous forme de pointeur vers une structure [XGMemoryLayoutMapping](/fr/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping). Cette méthode est similaire à la méthode [XGMemoryLayout::MapFromPattern](/fr/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapfrompattern), à la différence que `MapFromPattern` mappe les pages à l'aide d'un modèle prédéfini transmis sous forme de tableau d'octets.

<a id="requirements" />

## Configuration requise

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

<a id="ID4EWB" />

**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)
- [CopyTileMappings](/fr/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [GameInputAxisMapping](/fr/reference/input/gameinput/structs/gameinputaxismapping.md)
- [OpenExistingHeapFromFileMapping](/fr/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_TILE_MAPPING_FLAGS](/fr/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)