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

Transfère de la mémoire entre des partitions.

<a id="syntaxSection" />

## Syntaxe

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

<a id="parametersSection" />

### Paramètres

*TransferType*   \_In\_<br />Type : [XMEM\_TRANSFER\_TYPE](/fr/reference/system/xmem/enums/xmem_transfer_type)

Spécifie les partitions source et de destination de la mémoire à transférer.

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

Quantité de mémoire à transférer entre les partitions, en octets. La valeur est arrondie à la limite de 2 Mo supérieure. Si cette valeur est définie sur zéro, aucune mémoire n'est transférée.

<a id="retvalSection" />

### Valeur renvoyée

Type : BOOL

Renvoie `TRUE` si la mémoire a été transférée avec succès entre les partitions ou si `TransferSize` a été défini sur zéro ; sinon, `FALSE`. Pour obtenir des informations d'erreur étendues, appelez <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>.

<a id="remarksSection" />

## Remarques

Cette fonction transfère de la mémoire, par pages de 2 Mo, entre des partitions. Si `TransferSize` est défini sur une valeur supérieure à zéro, la valeur est arrondie à la limite de 2 Mo supérieure. Si la valeur est définie sur zéro, aucune mémoire n'est transférée et la fonction renvoie `TRUE`.

Lors de l'utilisation du mode de mémoire Advanced pour la famille de consoles XBOX Series X ou pour la famille de consoles XBOX Series X|S en mode AnacondaProfiling, les contraintes supplémentaires suivantes s'appliquent :

* `XMemTransferToolsToTitle` transfère uniquement de la mémoire GPU Optimal Bandwidth.  Cette fonctionnalité est similaire à l'option `ExtraTitleMemory` de l'outil Configuration (xbconfig.exe) inclus dans XBOX Tools Framework (XTF). Pour plus d'informations, consultez [Configuration (xbconfig.exe)](/fr/tools/tools-console/commandlinetools/xbconfig).
* `XMemTransferToolsToSystem` et `XMemTransferTitleToSystem` transfèrent uniquement de la mémoire Standard Bandwidth.

Lors de l'utilisation du mode Lockhart Profiling, `XMemTransferToolsToTitle` n'est pas pris en charge.

Pour plus d'informations sur les configurations de mémoire des familles de consoles, consultez [Configuration de la mémoire pour votre titre et votre kit de développement](/fr/build/console-features/memory/system-memory-tooling).

<Note>
  La mémoire transférée vers le système est conservée entre les appels à [XLaunchNewGame](/fr/reference/system/xgame/functions/xlaunchnewgame).
</Note>

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xmem.h

**Bibliothèque :** xmem.lib

**Plateformes prises en charge** : consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Voir aussi

[Mémoire](/fr/build/console-features/memory/system-memory-overview)<br />[XMem](/fr/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)