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

# XMemGetPhysicalMemoryLayout

> XMemGetPhysicalMemoryLayout retorna o layout de memória física da memória acessível ao título no console XBOX atual por meio de XMEM_PHYSICAL_MEMORY_LAYOUT.

# XMemGetPhysicalMemoryLayout

Retorna informações sobre o layout de memória física da memória acessível ao título no console atual.

## Sintaxe

```cpp theme={null}
BOOL XMemGetPhysicalMemoryLayout(  
     PXMEM_PHYSICAL_MEMORY_LAYOUT layout
)  
```

### Parâmetros

*layout*   \_Out\_<br />Tipo: PXMEM\_PHYSICAL\_MEMORY\_LAYOUT

Ponteiro para uma estrutura [XMEM\_PHYSICAL\_MEMORY\_LAYOUT](/pt-BR/reference/system/xmem/structs/xmem_physical_memory_layout) na qual são retornadas informações sobre o layout de memória do console atual.

### Valor retornado

Tipo: BOOL

Se a função tiver êxito, o valor retornado será **TRUE**.

Se a função falhar, o valor retornado será **FALSE**. Para obter informações de erro estendidas, chame <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>.

## Comentários

XMemGetPhysicalMemoryLayout retorna o menor número de página que pode ser retornado ao código do título por meio de [XMemAllocatePhysicalPages](/pt-BR/reference/system/xmem/functions/xmemallocatephysicalpages).  Em dispositivos Anaconda e em dispositivos Dante emulando Anaconda, ao usar o modo de memória de título Avançado, o menor número de página da memória com largura de banda ideal para a GPU será diferente (maior) do que o menor número de página da memória acessível ao título.  As páginas físicas que o título alocou podem ser comparadas a esses limites para determinar a categoria de largura de banda da página.

A memória acessível ao título tem a garantia de ser fisicamente contígua, permitindo que o código do aplicativo também determine o número de página do limite superior.

<Note>
  Os valores retornados por XMemGetPhysicalMemoryLayout nunca serão alterados durante a vida útil do processo e podem ser consultados uma vez e, em seguida, armazenados em cache no código do aplicativo.  No entanto, não há garantia de que os valores permaneçam consistentes entre dispositivos ou recuperações.  O código do aplicativo não deve codificar suposições com base na observação dos valores retornados por XMemGetPhysicalMemoryLayout que não tenham sido explicitamente garantidas de outra forma.
</Note>

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas com suporte:** consoles da família XBOX One e consoles XBOX Series

## Confira também

[Referência de XMem](/pt-BR/reference/system/xmem/xmem_members)<br />[XMemAllocatePhysicalPages](/pt-BR/reference/system/xmem/functions/xmemallocatephysicalpages)


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)
- [Working with the Microsoft GDK Game OS memory manager](/build/console-features/memory/system-memory-working.md)
- [XMemMapPhysicalPages](/reference/system/xmem/functions/xmemmapphysicalpages.md)