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

# XMemGetPhysicalMemoryLayout

> XMemGetPhysicalMemoryLayout 會透過 XMEM_PHYSICAL_MEMORY_LAYOUT 傳回目前 XBOX 主機上遊戲可存取記憶體的實體記憶體配置。

# XMemGetPhysicalMemoryLayout

傳回目前主機上遊戲可存取記憶體之實體記憶體配置的相關資訊。

## 語法

```cpp theme={null}
BOOL XMemGetPhysicalMemoryLayout(  
     PXMEM_PHYSICAL_MEMORY_LAYOUT layout
)  
```

### 參數

*layout*   \_Out\_<br />類型：PXMEM\_PHYSICAL\_MEMORY\_LAYOUT

指向 [XMEM\_PHYSICAL\_MEMORY\_LAYOUT](/zh-TW/reference/system/xmem/structs/xmem_physical_memory_layout) 結構的指標，目前主機記憶體配置的相關資訊會傳回到此結構中。

### 傳回值

類型：BOOL

如果函式成功，傳回值為 **TRUE**。

如果函式失敗，傳回值為 **FALSE**。若要取得延伸錯誤資訊，請呼叫 <a href="https://msdn.microsoft.com/library/windows/desktop/ms679360(v=vs.85).aspx">GetLastError</a>。

## 備註

XMemGetPhysicalMemoryLayout 會傳回可透過 [XMemAllocatePhysicalPages](/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages) 傳回給遊戲程式碼的最低頁碼。在 Anaconda 裝置以及模擬 Anaconda 的 Dante 裝置上，使用進階遊戲記憶體模式時，GPU 最佳頻寬記憶體的最低頁碼會與遊戲可存取記憶體的最低頁碼不同 (較高)。遊戲已配置的實體頁面可以與這些邊界進行比較，以判斷頁面的頻寬類別。

遊戲可存取記憶體保證在實體上是連續的，讓應用程式程式碼也能判斷上限頁碼。

<Note>
  XMemGetPhysicalMemoryLayout 傳回的值在處理程序的生命週期內永遠不會變更，可以查詢一次，然後在應用程式程式碼中快取。不過，這些值不保證在不同裝置或復原之間保持一致。應用程式程式碼不應根據觀察 XMemGetPhysicalMemoryLayout 傳回的值，硬式編碼任何未另外明確保證的假設。
</Note>

## 需求

**標頭：** xmem.h

**程式庫：** xmem.lib

**支援的平台：** XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

[XMem 參考](/zh-TW/reference/system/xmem/xmem_members)<br />[XMemAllocatePhysicalPages](/zh-TW/reference/system/xmem/functions/xmemallocatephysicalpages)


## 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)
- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](/ja-jp/nda/nda-topic-directory.md)
- [Working with the Microsoft GDK Game OS memory manager](/build/console-features/memory/system-memory-working.md)
- [XMemMapPhysicalPages](/reference/system/xmem/functions/xmemmapphysicalpages.md)