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

# MapRunLengthArray (XBOX One 系列)

> 使用語彙基元的執行長度陣列來對應頁面。

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

使用語彙基元的執行長度陣列來對應頁面。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT MapRunLengthArray(
         XGMemoryLayoutMapping *pMapping,
         const USHORT *pTokens,
         UINT32 TokenCount,
         UINT32 PageCount,
         UINT32 MaxEsramPageCount
)  
```

<a id="ID4EG" />

### 參數

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

更新後的對應結果，以指向 [XGMemoryLayoutMapping](/zh-TW/reference/graphics/xgmemory_NR/structs/xgmemorylayoutmapping) 結構的指標表示。

*pTokens*   \_In\_reads\_(TokenCount)\
類型: USHORT\*

語彙基元的執行長度陣列。

*TokenCount*   \
類型: UINT32

語彙基元執行長度陣列中的語彙基元數目。每個語彙基元代表一個 ESRAM 或系統頁面區塊。

*PageCount*   \
類型: UINT32

語彙基元執行長度陣列中的頁面總數，包括系統頁面和 ESRAM 頁面。此計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。

如果 *PageCount* 為 XG\_ALL\_REMAINING\_PAGES，則會以 [XGMemoryLayout::GetPageCountRemaining](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getpagecountremaining) 取代。

*MaxEsramPageCount*\
類型: UINT32

語彙基元執行長度陣列中的 ESRAM 頁面數目上限。此計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。

如果 *MaxEsramPageCount* 為 XG\_ALL\_REMAINING\_PAGES，則會以 [XGMemoryLayout::GetFreeEsramPageCount](/zh-TW/reference/graphics/xgmemory_NR/interfaces/XGMemoryLayout/methods/xgmemorylayout_getfreeesrampagecount) 取代。

<a id="ID4EP" />

### 傳回值

類型: HRESULT

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

<a id="remarks" />

## 備註

此方法使用語彙基元的執行長度陣列來對應頁面。每個語彙基元代表一個 ESRAM 或系統頁面區塊；如需詳細資料，請參閱 xgmemory.h 中的 **EsramToken** 和 **SystemToken** #define 巨集。

對應會以特定的頁面計數和 ESRAM 頁面計數上限建立。這些計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。

<a id="requirements" />

## 需求

**標頭:** xgmemory.h

<a id="ID4EED" />

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

## 另請參閱

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


## Related topics

- [Map](/zh-CN/reference/graphics/d3d12/interfaces/id3d12resource/methods/id3d12resource_map_public.md)
- [XMemMapPhysicalPages](/zh-CN/reference/system/xmem/functions/xmemmapphysicalpages.md)
- [ApuMapApuAddress](/zh-CN/reference/audio/apu/functions/apumapapuaddress.md)
- [ApuMapVirtualAddress](/zh-CN/reference/audio/apu/functions/apumapvirtualaddress.md)
- [XMemMapPhysicalPagesScatter](/zh-CN/reference/system/xmem/functions/xmemmapphysicalpagesscatter.md)