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

# RelinquishMapping (famille XBOX One)

> Libère un mappage défini précédemment et remet ses pages ESRAM et système dans les listes de pages libres.

# Méthode XGMemoryLayout::RelinquishMapping (famille XBOX One)

Libère un mappage défini précédemment et remet ses pages ESRAM et système dans les listes de pages libres.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT RelinquishMapping(
         const XGMemoryLayoutMapping *pMapping,
         UINT32 Flags
)  
```

<a id="ID4EG" />

### Paramètres

*pMapping*   \_In\_\
Type : XGMemoryLayoutMapping \*

Le mappage défini précédemment à libérer, sous la forme d'un pointeur vers une structure [XGMemoryLayoutMapping](/fr-CA/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

*Flags*   \
Type : UINT32

Indicateurs permettant de contrôler cette méthode, sous forme de combinaisons par OR au niveau du bit de constantes d'énumération [XG\_RELINQUISH\_MAPPING\_FLAGS](/fr-CA/reference/graphics/xgmemory_NR/enums/xg_relinquish_mapping_flags) qui indiquent s'il faut conserver le mappage des pages ESRAM et des pages de mémoire système.

<a id="ID4EP" />

### Valeur de retour

Type : HRESULT

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

<a id="remarks" />

## Remarques

Cette méthode libère un mappage défini précédemment et remet ses pages ESRAM et système dans les listes de pages libres. Cela n'annule pas le mappage des pages, qui sont recyclées pour la création de futurs mappages dans cette disposition. Par conséquent, considérez la libération d'un mappage comme une barrière; l'utilisation de la mémoire dans le mappage libéré doit strictement précéder toute utilisation de cette mémoire dans les futurs mappages.

<a id="requirements" />

## Configuration requise

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

<a id="ID4EVB" />

**Plateformes prises en charge :** famille XBOX One

## Voir aussi

[XGMemoryLayout](/fr-CA/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Documentation de développement de jeux XBOX](/fr-CA/index.md)
- [CopyTileMappings](/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)