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

# XMemTransferMemory

> XMemTransferMemory

# XMemTransferMemory

Transfere memória entre partições.

<a id="syntaxSection" />

## Sintaxe

```cpp theme={null}
BOOL XMemTransferMemory(  
         XMEM_TRANSFER_TYPE TransferType,  
         SIZE_T TransferSize  
)  
```

<a id="parametersSection" />

### Parâmetros

*TransferType*   \_In\_<br />Tipo: [XMEM\_TRANSFER\_TYPE](/pt-BR/reference/system/xmem/enums/xmem_transfer_type)

Especifica as partições de origem e de destino da memória a ser transferida.

*TransferSize*   \_In\_<br />Tipo: SIZE\_T

A quantidade de memória a ser transferida entre partições, em bytes. O valor é arredondado para cima até o próximo limite de 2 MB. Se esse valor for definido como zero, nenhuma memória será transferida.

<a id="retvalSection" />

### Valor retornado

Tipo: BOOL

Retorna `TRUE` se a memória foi transferida com êxito entre partições ou se `TransferSize` foi definido como zero; caso contrário, `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>.

<a id="remarksSection" />

## Comentários

Essa função transfere memória, em páginas de 2 MB, entre partições. Se `TransferSize` for definido como um valor maior que zero, o valor será arredondado para cima até o próximo limite de 2 MB. Se o valor for definido como zero, nenhuma memória será transferida e a função retornará `TRUE`.

Ao usar o modo de memória Avançado para a família de consoles XBOX Series X ou para a família de consoles XBOX Series X|S no modo AnacondaProfiling, as seguintes restrições adicionais se aplicam:

* `XMemTransferToolsToTitle` transfere somente memória GPU Optimal Bandwidth.  Essa funcionalidade é semelhante à opção `ExtraTitleMemory` na ferramenta Configuração (xbconfig.exe) incluída no XBOX Tools Framework (XTF). Para obter mais informações, consulte [Configuração (xbconfig.exe)](/pt-BR/tools/tools-console/commandlinetools/xbconfig).
* `XMemTransferToolsToSystem` e `XMemTransferTitleToSystem` transferem somente memória Standard Bandwidth.

Ao usar o Modo de Criação de Perfil do Lockhart, `XMemTransferToolsToTitle` não tem suporte.

Para obter mais informações sobre as configurações de memória das famílias de consoles, consulte [Configurando a memória para seu título e kit de desenvolvimento](/pt-BR/build/console-features/memory/system-memory-tooling).

<Note>
  A memória transferida para o sistema é mantida entre chamadas para [XLaunchNewGame](/pt-BR/reference/system/xgame/functions/xlaunchnewgame).
</Note>

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xmem.h

**Biblioteca:** xmem.lib

**Plataformas compatíveis**: consoles da família XBOX One e consoles XBOX Series

<a id="seealsoSection" />

## Confira também

[Memória](/pt-BR/build/console-features/memory/system-memory-overview)<br />[XMem](/pt-BR/reference/system/xmem/xmem_members)


## Related topics

- [Profile-guided optimization in Visual Studio](/tools/tools-console/pgo/pgo_full.md)
- [Optimización guiada por perfiles en Visual Studio](/es/tools/tools-console/pgo/pgo_full.md)
- [Visual Studio에서의 프로필 기반 최적화](/ko/tools/tools-console/pgo/pgo_full.md)
- [XLaunchNewGame](/reference/system/xgame/functions/xlaunchnewgame.md)
- [Visual Studio でのプロファイルガイド付き最適化](/ja-jp/tools/tools-console/pgo/pgo_full.md)