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

# Classe XGMemoryLayout (conteúdo da interface) (família XBOX One)

> Representa um único layout de um intervalo de endereços virtuais, mapeado para páginas de ESRAM e/ou de memória do sistema armazenadas no XGMemoryLayoutEngine.

Representa um único layout de um intervalo de endereços virtuais, mapeado para páginas de ESRAM e/ou de memória do sistema armazenadas no [XGMemoryLayoutEngine](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayoutEngine/xgmemorylayoutengine).

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
class XGMemoryLayout : public XGRefCount  
```

## Métodos

| Método | Descrição |
| - | - |
| [CopyMapping](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_copymapping) | Copia um mapeamento de origem para um mapeamento de destino. Oferece a opção de substituir os mapeamentos de páginas de ESRAM no mapeamento de origem pelas páginas de memória do sistema recém-alocadas no mapeamento de destino. |
| [CreateMapping](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_createmapping) | Cria um novo mapeamento com o nome especificado. |
| [EnsureMappingSize](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_ensuremappingsize) | Verifica se o layout tem espaço de endereço virtual restante para um mapeamento do tamanho especificado, em páginas. |
| [GetBaseAddress](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getbaseaddress) | Retorna, como um ponteiro **void**, o endereço virtual base da GPU deste layout. |
| [GetCurrentAddress](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getcurrentaddress) | Retorna, como um ponteiro void, o endereço virtual atual deste layout enquanto ele é construído. |
| [GetCurrentPageOffset](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getcurrentpageoffset) | Retorna o deslocamento de página atual deste layout enquanto ele é construído. |
| [GetEsramPageRanges](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getesrampageranges) | Retorna um conjunto de intervalos de páginas dentro do mapeamento que estão mapeados para páginas de ESRAM. |
| [GetFreeEsramPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) | Retorna o número de páginas de ESRAM livres restantes. |
| [GetFreeSystemPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreesystempagecount) | Retorna o número de páginas de memória do sistema livres restantes. |
| [GetGpuBaseAddress](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getgpubaseaddress) | Retorna, como um XG\_GPU\_VIRTUAL\_ADDRESS (um UINT64), o endereço virtual base da GPU deste layout. |
| [GetGpuCurrentAddress](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getgpucurrentaddress) | Retorna, como um XG\_GPU\_VIRTUAL\_ADDRESS (um UINT64), o endereço virtual atual deste layout enquanto ele é construído. |
| [GetMaxUsedEsramPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getmaxusedesrampagecount) | Retorna o número máximo de páginas de ESRAM em uso simultaneamente neste layout. |
| [GetMaxUsedSystemPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getmaxusedsystempagecount) | Retorna o número máximo de páginas de memória do sistema em uso simultaneamente neste layout. |
| [GetPageCount](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecount) | Retorna o número de páginas no layout. |
| [GetPageCountRemaining](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) | Retorna o número de páginas não mapeadas restantes neste layout. |
| [GetPageSizeBytes](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagesizebytes) | Retorna o tamanho, em bytes, de uma página neste layout. |
| [IsValid](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_isvalid) | Retorna true se o layout atual for válido. |
| [MapFromPattern](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapfrompattern) | Mapeia páginas usando um padrão predefinido passado como uma matriz de bytes. |
| [MapPagePriorityArray](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mappagepriorityarray) | Mapeia páginas usando uma matriz de prioridade de páginas. |
| [MapRunLengthArray](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_maprunlengtharray) | Mapeia páginas usando uma matriz de tokens com codificação run-length. |
| [MapSimple](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapsimple) | Mapeia páginas usando uma organização simples de páginas de ESRAM, seguidas por páginas de memória do sistema. |
| [RelinquishMapping](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_relinquishmapping) | Abre mão de um mapeamento definido anteriormente e coloca suas páginas de ESRAM e do sistema de volta nas listas livres. |
| [XGMemoryLayout::Reset](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_reset) | Redefine o layout, descompromete todas as páginas do intervalo de endereços virtuais, retorna todas as páginas de ESRAM e de memória do sistema às listas livres e invalida todos os mapeamentos feitos neste layout. |

<a id="requirements" />

## Requisitos

**Cabeçalho:** xgmemory.h

**Plataformas com suporte:** família XBOX One

## Confira também

[xgmemory](/pt-BR/reference/graphics/xgmemory_NR/xgmemory_members)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Índice de tópicos sob NDA para desenvolvimento de console com o XBOX GDK](/pt-BR/nda/nda-overview.md)
- [Intelligent Delivery: especificadores de dispositivo](/pt-BR/build/core-features/common/packaging/intelligentdelivery-device.md)
- [PIXRecordMemoryAllocationEvent](/pt-BR/reference/tools/pix3/functions/pixrecordmemoryallocationevent.md)
- [PIXRecordMemoryFreeEvent](/pt-BR/reference/tools/pix3/functions/pixrecordmemoryfreeevent.md)