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

# GetEsramPageRanges (XBOX One 系列)

> 傳回對應中已對應至 ESRAM 頁面的一組頁面範圍。

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

傳回對應中已對應至 ESRAM 頁面的一組頁面範圍。

<a id="syntaxSection" />

## 語法

```cpp theme={null}
HRESULT GetEsramPageRanges(
         const XGMemoryLayoutMapping *pMapping,
         XGMemoryPageRange *pRanges,
         UINT32 *pRangeCount
)  
```

<a id="ID4EG" />

### 參數

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

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

*pRanges*   \_Out\_writes\_(\*pRangeCount)\
類型: XGMemoryPageRange \*

[XGMemoryPageRange](/zh-TW/reference/graphics/xgmemory_NR/structs/xgmemorypagerange) 結構的陣列。

*pRangeCount*   \_Inout\_\
類型: UINT32\*

呼叫此方法時，請傳入指向 *pRanges* 陣列中範圍結構數目的指標。呼叫傳回後，這會是指向已輸出且內容有效之頁面範圍數目的指標。

<a id="ID4EP" />

### 傳回值

類型: HRESULT

S\_OK、E\_INVALIDARG 或 E\_OUTOFMEMORY。如果頁面範圍陣列的大小不足以描述所有 ESRAM 範圍，此方法會傳回 E\_INVALIDARG。

<a id="requirements" />

## 需求

**標頭:** xgmemory.h

<a id="ID4E3B" />

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

## 另請參閱

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


## Related topics

- [NDA topic directory - live Microsoft Learn links](/nda/nda-topic-directory.md)
- [Répertoire des rubriques NDA : liens actifs vers Microsoft Learn](/fr/nda/nda-topic-directory.md)
- [Diretório de tópicos NDA: links ativos do Microsoft Learn](/pt-BR/nda/nda-topic-directory.md)
- [Directorio de temas NDA: enlaces activos a Microsoft Learn](/es/nda/nda-topic-directory.md)
- [D3D12_RANGE](/zh-CN/reference/graphics/d3d12/structs/d3d12_range_public.md)