> ## 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 (família XBOX One)

> Libera um mapeamento definido anteriormente e coloca suas páginas ESRAM e do sistema de volta nas listas livres.

# Método XGMemoryLayout::RelinquishMapping (família XBOX One)

Libera um mapeamento definido anteriormente e coloca suas páginas ESRAM e do sistema de volta nas listas livres.

<a id="syntaxSection" />

## Sintaxe

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

<a id="ID4EG" />

### Parâmetros

*pMapping*   \_In\_\
Tipo: XGMemoryLayoutMapping \*

O mapeamento definido anteriormente a ser liberado, como um ponteiro para uma estrutura [XGMemoryLayoutMapping](/pt-BR/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping).

*Flags*   \
Tipo: UINT32

Sinalizadores para controlar este método, como combinações com OR bit a bit de constantes de enumeração [XG\_RELINQUISH\_MAPPING\_FLAGS](/pt-BR/reference/graphics/xgmemory_NR/enums/xg_relinquish_mapping_flags) que indicam se o mapeamento de páginas ESRAM e de páginas de memória do sistema deve ser preservado.

<a id="ID4EP" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarks" />

## Comentários

Este método libera um mapeamento definido anteriormente e coloca suas páginas ESRAM e do sistema de volta nas listas livres. Isso não desfaz o mapeamento das páginas, que são recicladas para uso na criação de mapeamentos futuros neste layout. Portanto, considere a liberação de um mapeamento como uma barreira; o uso da memória no mapeamento liberado deve preceder estritamente o uso de qualquer parte dessa memória em mapeamentos futuros.

<a id="requirements" />

## Requisitos

**Cabeçalho:** xgmemory.h

<a id="ID4EVB" />

**Plataformas compatíveis:** família XBOX One

## Confira também

[XGMemoryLayout](/pt-BR/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CopyTileMappings](/pt-BR/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [GameInputAxisMapping](/pt-BR/reference/input/gameinput/structs/gameinputaxismapping.md)
- [OpenExistingHeapFromFileMapping](/pt-BR/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_TILE_MAPPING_FLAGS](/pt-BR/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)