> ## 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 (família XBOX One)

> Cria um novo mapeamento com o nome especificado.

# Método XGMemoryLayout::CreateMapping (família XBOX One)

Cria um novo mapeamento com o nome especificado.

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EG" />

### Parâmetros

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

O nome do novo mapeamento.

*pMapping*   \_Out\_\
Tipo: XGMemoryLayoutMapping \*

O novo mapeamento como um ponteiro para uma estrutura [XGMemoryLayoutMapping](/pt-BR/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

*AlignmentBytes*   \_In\_\
Tipo: UINT32

O alinhamento do endereço virtual do mapeamento, em bytes. Especifique 0 para o alinhamento padrão de `XG_GPU_PAGE_SIZE_BYTES`.

<a id="ID4EP" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarks" />

## Comentários

Cria um novo mapeamento com o nome fornecido. Defina AlignmentBytes como 0 para usar o alinhamento padrão, `XG_GPU_PAGE_SIZE_BYTES`, para o alinhamento do endereço virtual do mapeamento.

Essa constante representa o tamanho, em bytes, de uma página de GPU do XG.

Esse tamanho normalmente é de 64 KB, o que pode ser verificado por meio do método [XGMemoryLayout::GetPageSizeBytes](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagesizebytes).

O novo mapeamento é criado como um ponteiro para uma estrutura [XGMemoryLayoutMapping](/pt-BR/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping). Este método é semelhante ao método [XGMemoryLayout::MapFromPattern](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapfrompattern), com a diferença de que `MapFromPattern` mapeia páginas usando um padrão predefinido passado como uma matriz de bytes.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xgmemory.h

<a id="ID4EWB" />

**Plataformas compatíveis:** família XBOX One

## Confira também

[XGMemoryLayout](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CopyTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [GameInputAxisMapping](/pt-BR/reference/input/gameinput/structs/gameinputaxismapping.md)
- [OpenExistingHeapFromFileMapping](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_TILE_MAPPING_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)