> ## 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 (XBOX One 系列)

> 放棄先前定義的對應，並將其 ESRAM 和系統頁面放回可用清單。

# XGMemoryLayout::RelinquishMapping 方法 (XBOX One 系列)

放棄先前定義的對應，並將其 ESRAM 和系統頁面放回可用清單。

<a id="syntaxSection" />

## 語法

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

<a id="ID4EG" />

### 參數

*pMapping*   \_In\_\
類型: XGMemoryLayoutMapping \*

要放棄的先前定義對應，以指向 [XGMemoryLayoutMapping](/zh-TW/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping) 結構的指標表示。

*Flags*   \
類型: UINT32

控制此方法的旗標，為 [XG\_RELINQUISH\_MAPPING\_FLAGS](/zh-TW/reference/graphics/xgmemory_NR/enums/xg_relinquish_mapping_flags) 列舉常數的位元 OR 組合，指出是否要保留 ESRAM 頁面和系統記憶體頁面的對應。

<a id="ID4EP" />

### 傳回值

類型: HRESULT

S\_OK、E\_INVALIDARG 或 E\_OUTOFMEMORY。

<a id="remarks" />

## 備註

此方法會放棄先前定義的對應，並將其 ESRAM 和系統頁面放回可用清單。這不會取消對應這些頁面，它們會被回收，以便在此配置中建立後續的對應時使用。因此，請將放棄對應視為一道屏障；已放棄對應中的記憶體使用，必須嚴格早於後續對應中對該記憶體的任何使用。

<a id="requirements" />

## 需求

**標頭:** xgmemory.h

<a id="ID4EVB" />

**支援的平台:** XBOX One 系列

## 另請參閱

[XGMemoryLayout](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout)


## Related topics

- [CopyTileMappings](/zh-CN/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [OpenExistingHeapFromFileMapping](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)
- [D3D12_SHADER_COMPONENT_MAPPING](/zh-CN/reference/graphics/d3d12/enums/d3d12_shader_component_mapping_public.md)
- [D3D12_TILE_MAPPING_FLAGS](/zh-CN/reference/graphics/d3d12/enums/d3d12_tile_mapping_flags_public.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)