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

> Mapeia páginas usando um padrão predefinido passado como uma matriz de bytes.

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

Mapeia páginas usando um padrão predefinido passado como uma matriz de bytes.

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EG" />

### Parâmetros

*pMapping*   \_Inout\_\
Tipo: XGMemoryLayoutMapping \*

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

*PageCount*   \
Tipo: UINT32

O número de páginas com as quais criar este mapeamento, incluindo páginas ESRAM e páginas do sistema. Essa contagem ajustará o padrão em comprimento e/ou uso de ESRAM. Se o padrão não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

Se *PageCount* for XG\_ALL\_REMAINING\_PAGES, então [XGMemoryLayout::GetPageCountRemaining](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) é usado no lugar como *PageCount*.

*pPattern*   \_In\_reads\_(PatternSizeBytes)\
Tipo: BYTE\*

O padrão predefinido, como uma matriz de bytes.

*PatternSizeBytes*   \
Tipo: SIZE\_T

O tamanho do padrão predefinido.

*MaxEsramPageCount*   \
Tipo: UINT32

O número máximo de páginas ESRAM com as quais o mapeamento deve ser criado. Essa contagem ajustará o padrão em comprimento e/ou uso de ESRAM. Se o padrão não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

Se *MaxEsramPageCount* for XG\_ALL\_REMAINING\_PAGES, então [XGMemoryLayout::GetFreeEsramPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) é usado no lugar como *MaxEsramPageCount*.

<a id="ID4EP" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarks" />

## Comentários

O mapeamento é criado com uma contagem de páginas específica e uma contagem máxima de páginas ESRAM. Essas contagens ajustarão o padrão em comprimento e/ou uso de ESRAM. Se o padrão não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xgmemory.h

<a id="ID4E5C" />

**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)
- [Map](/pt-BR/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [ApuMapApuAddress](/pt-BR/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuMapVirtualAddress](/pt-BR/reference/audio/apu/functions/apumapvirtualaddress.md)
- [XMemMapPhysicalPages](/pt-BR/reference/system/xmem/functions/xmemmapphysicalpages.md)