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

# XGMemoryLayoutMapping (XBOX One 系列)

> 代表記憶體配置內的單一對應。

代表記憶體配置內的單一對應。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
typedef struct XGMemoryLayoutMapping {  
    UINT32 StartPageIndex;
    UINT32 PageCount;
    XG_GPU_VIRTUAL_ADDRESS MappingBaseAddress;
    UINT32 EsramPageCount;
} XGMemoryLayoutMapping  
```

<a id="ID4EG" />

### 成員

*StartPageIndex*\
類型：UINT32

此對應的虛擬位址範圍在配置內的起始 64KB 頁面索引。

*PageCount*\
類型：UINT32

此對應的虛擬位址範圍中的 64KB 頁面數目。

*MappingBaseAddress*\
類型：XG\_GPU\_VIRTUAL\_ADDRESS

對應的基底虛擬位址，以 XG\_GPU\_VIRTUAL\_ADDRESS 表示。

*EsramPageCount*\
類型：UINT32

已對應至此對應的 ESRAM 頁面數目。

<a id="remarks" />

## 備註

下列方法會使用此結構：

* [XGMemoryLayout::CopyMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_copymapping)
* [XGMemoryLayout::CreateMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_createmapping)
* [XGMemoryLayout::GetEsramPageRanges](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getesrampageranges)
* [XGMemoryLayout::MapFromPattern](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapfrompattern)
* [XGMemoryLayout::MapPagePriorityArray](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mappagepriorityarray)
* [XGMemoryLayout::MapRunLengthArray](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_maprunlengtharray)
* [XGMemoryLayout::MapSimple](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_mapsimple)
* [XGMemoryLayout::RelinquishMapping](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_relinquishmapping)

<a id="requirements" />

## 需求

**標頭：** xgmemory.h

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

## 另請參閱

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


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [CopyTileMappings](/zh-CN/reference/graphics/d3d12/interfaces/id3d12commandqueue/methods/id3d12commandqueue_copytilemappings_public.md)
- [NDA topics index for XBOX GDK console development](/nda/nda-overview.md)
- [OpenExistingHeapFromFileMapping](/zh-CN/reference/graphics/d3d12/interfaces/id3d12device3/methods/id3d12device3_openexistingheapfromfilemapping_public.md)