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

# XGMemoryLayout 類別 (介面內容) (XBOX One 系列)

> 代表虛擬位址範圍的單一配置，對應至儲存在 XGMemoryLayoutEngine 中的 ESRAM 和/或系統記憶體頁面。

代表虛擬位址範圍的單一配置，對應至儲存在 [XGMemoryLayoutEngine](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayoutEngine/xgmemorylayoutengine) 中的 ESRAM 和/或系統記憶體頁面。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
class XGMemoryLayout : public XGRefCount  
```

## 方法

| 方法 | 描述 |
| - | - |
| [CopyMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_copymapping) | 將來源對應複製到目的地對應。可選擇以目的地對應中新配置的系統記憶體頁面，取代來源對應中的 ESRAM 頁面對應。 |
| [CreateMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_createmapping) | 以指定的名稱建立新的對應。 |
| [EnsureMappingSize](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_ensuremappingsize) | 檢查配置是否還有足夠的剩餘虛擬位址空間，可容納指定大小 (以頁面為單位) 的對應。 |
| [GetBaseAddress](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getbaseaddress) | 以 **void** 指標傳回此配置的基底 GPU 虛擬位址。 |
| [GetCurrentAddress](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getcurrentaddress) | 在此配置建構期間，以 void 指標傳回其目前的虛擬位址。 |
| [GetCurrentPageOffset](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getcurrentpageoffset) | 在此配置建構期間，傳回其目前的頁面位移。 |
| [GetEsramPageRanges](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getesrampageranges) | 傳回對應中已對應至 ESRAM 頁面的一組頁面範圍。 |
| [GetFreeEsramPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) | 傳回剩餘的可用 ESRAM 頁面數目。 |
| [GetFreeSystemPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreesystempagecount) | 傳回剩餘的可用系統記憶體頁面數目。 |
| [GetGpuBaseAddress](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getgpubaseaddress) | 以 XG\_GPU\_VIRTUAL\_ADDRESS (UINT64) 傳回此配置的基底 GPU 虛擬位址。 |
| [GetGpuCurrentAddress](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getgpucurrentaddress) | 在此配置建構期間，以 XG\_GPU\_VIRTUAL\_ADDRESS (UINT64) 傳回其目前的虛擬位址。 |
| [GetMaxUsedEsramPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getmaxusedesrampagecount) | 傳回此配置中同時使用的 ESRAM 頁面數目上限。 |
| [GetMaxUsedSystemPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getmaxusedsystempagecount) | 傳回此配置中同時使用的系統記憶體頁面數目上限。 |
| [GetPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecount) | 傳回配置中的頁面數目。 |
| [GetPageCountRemaining](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) | 傳回此配置中剩餘的未對應頁面數目。 |
| [GetPageSizeBytes](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagesizebytes) | 傳回此配置中一個頁面的大小 (以位元組為單位)。 |
| [IsValid](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_isvalid) | 如果目前的配置有效，則傳回 true。 |
| [MapFromPattern](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapfrompattern) | 使用以位元組陣列傳入的預先定義模式來對應頁面。 |
| [MapPagePriorityArray](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mappagepriorityarray) | 使用頁面優先順序陣列來對應頁面。 |
| [MapRunLengthArray](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_maprunlengtharray) | 使用權杖的執行長度陣列來對應頁面。 |
| [MapSimple](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapsimple) | 使用先 ESRAM 頁面、後系統記憶體頁面的簡單排列方式來對應頁面。 |
| [RelinquishMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_relinquishmapping) | 放棄先前定義的對應，並將其 ESRAM 和系統頁面放回可用清單。 |
| [XGMemoryLayout::Reset](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_reset) | 重設配置、從虛擬位址範圍解除認可所有頁面、將所有 ESRAM 和系統記憶體頁面傳回可用清單，並使在此配置上建立的所有對應失效。 |

<a id="requirements" />

## 需求

**標頭：** xgmemory.h

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

## 另請參閱

[xgmemory](/zh-TW/reference/graphics/xgmemory_NR/xgmemory_members)


## Related topics

- [NDA 主題目錄 - Microsoft Learn 線上連結](/zh-TW/nda/nda-topic-directory.md)
- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [XBOX 遊戲的 XBOX 需求](/zh-TW/publishing/certification/xbox-requirements.md)
- [XBOX 主機遊戲的認證測試 XBOX 需求](/zh-TW/publishing/certification/console-cert-tested-requirements.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)