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

# XGMemory 參考 (API 內容) (XBOX One 系列)

> XGMemory 協助程式庫可管理資源記憶體的動態對應。它支援轉譯目標的混合 ESRAM 和系統記憶體配置。

XGMemory 是一個協助程式庫，可管理資源記憶體的動態對應：特別是轉譯目標的混合 ESRAM 和系統記憶體配置。XGMemory 可用來在一或多個配置之間，彈性地配置和重複使用一組固定的 ESRAM 和系統記憶體頁面。每個配置都是唯一的虛擬位址範圍，可在其中放置多個資源以進行轉譯。

XBOX Graphics Memory (XGMemory) API 提供 ESRAM 支援，並在 XGMemory.h 標頭檔中宣告。完整的實作可在該標頭以及同一目錄中對應的 xgmemory.inl 檔案中找到。沒有 .lib 檔案；XGMemory API 中的所有內容都定義在 xgmemory.inl 中。

<Warning>
  請注意，本節可能未與 Microsoft Game Development Kit (GDK) 保持同步，將在未來的版本中更新。Microsoft Game Development Kit (GDK) 不支援 D3D11。
</Warning>

## 介面

| 介面 | 描述 |
| - | - |
| [XGFreeList](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGFreeList/xgfreelist) | 請勿使用；僅供內部使用。 |
| [XGMemoryLayout](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/xgmemorylayout) | 代表虛擬位址範圍的單一配置，對應至儲存在 XGMemoryLayoutEngine 中的 ESRAM 和/或系統記憶體頁面。 |
| [XGMemoryLayoutEngine](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayoutEngine/xgmemorylayoutengine) | 適用於 ESRAM 和系統頁面的記憶體配置引擎。 |
| [XGRefCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGRefCount/xgrefcount) | 請勿使用；僅供內部使用。 |

## 結構

| 結構 | 描述 |
| - | - |
| [XGMemoryLayoutMapping](/zh-TW/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping) | 代表記憶體配置內的單一對應。 |
| [XGMemoryPageRange](/zh-TW/reference/graphics/xgmemory_NR/structs/xgmemorypagerange) | 代表配置的虛擬位址空間中的 64KB 頁面範圍。 |

## 列舉

| 列舉 | 描述 |
| - | - |
| [XG\_COPY\_MAPPING\_FLAGS](/zh-TW/reference/graphics/xgmemory_NR/enums/xg_copy_mapping_flags) | 用來控制 **XGMemoryLayout::CopyMapping** 的旗標，例如是否要取代 ESRAM 頁面和系統記憶體頁面的對應。 |
| [XG\_LAYOUT\_PATTERN\_TYPE](/zh-TW/reference/graphics/xgmemory_NR/enums/xg_layout_pattern_type) | 從 PIX 資料接收編碼模式時的配置模式類型識別碼。 |
| [XG\_RELINQUISH\_MAPPING\_FLAGS](/zh-TW/reference/graphics/xgmemory_NR/enums/xg_relinquish_mapping_flags) | 用來控制 [XGMemoryLayoutEngine::RelinquishMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_relinquishmapping) 的旗標，例如是否要保留 ESRAM 頁面和系統記憶體頁面的對應。 |

## 另請參閱


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [XBOX GDK 主机开发 NDA 主题索引](/zh-CN/nda/nda-overview.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [NDA topics index for XBOX GDK console development](/nda/nda-overview.md)
- [Índice de temas de NDA para el desarrollo de consolas con el GDK de XBOX](/es/nda/nda-overview.md)