XMemCreateWin32Heap
建立 Win32 堆積。語法
參數
HeapFlags _In_類型：ULONGLONG 表示要建立之堆積的記憶體來源。
baseAddress _In_
類型：PVOID 就地堆積配置的基底位址。如果
HeapFlags 設定為 XMEM_HEAP_INPLACE，此值必須指向已認可記憶體中對齊 4 KB 邊界的位址；否則，此值必須設定為 NULL。
傳回值
類型：HANDLE 如果成功，則傳回所建立 Win32 堆積的控制代碼；否則傳回NULL。如果可用，延伸錯誤資訊會提供給您應用程式目前的 XErrorCallback 回呼。
備註
此函式會建立 Win32 堆積，並分別從HeapFlags 和 baseAddress 所指示的來源和基底位址為堆積配置記憶體。如果建立堆積時未在 HeapFlags 中指定 XMEM_HEAP_INPLACE，堆積會由 2MB 頁面支援 (如果指定了 XMEM_HEAP_64K_PAGES，則為 64KB 頁面)。如果嘗試建立 Win32 堆積時發生錯誤，此方法會傳回 NULL，且如果可用，錯誤會回報給您應用程式目前的 XErrorCallback 回呼。如需處理例外錯誤情況的詳細資訊，請參閱 XError。
如需設定和存取記憶體的詳細資訊，請參閱為您的遊戲和開發套件設定記憶體。
配置工具記憶體
如果在HeapFlags 中指定 XMEM_HEAP_TOOL，函式會根據分析模式和反覆運算模式設定，嘗試從工具分割區配置記憶體以建立 Win32 堆積：
- 如果停用反覆運算模式並啟用分析模式，函式會嘗試從工具分割區配置所要求的記憶體量。如果所要求的量無法使用，就會發生錯誤。
- 如果停用反覆運算模式並停用分析模式，就會發生錯誤。
- 如果啟用反覆運算模式，函式會嘗試從遊戲分割區配置所要求的記憶體量。如果所要求的量無法使用，就會發生錯誤。
需求
標頭： xmem.h 程式庫： xmem.lib 支援的平台： XBOX One 系列主機和 XBOX Series 主機另請參閱
記憶體XMem