Skip to main content

XMemTransferMemory

在分割區之間傳輸記憶體。

語法

參數

TransferType _In_
類型:XMEM_TRANSFER_TYPE
指定要傳輸之記憶體的來源和目的地分割區。 TransferSize _In_
類型:SIZE_T
要在分割區之間傳輸的記憶體數量 (以位元組為單位)。此值會無條件進位到下一個 2 MB 邊界。如果此值設定為零,則不會傳輸任何記憶體。

傳回值

類型:BOOL 如果已成功在分割區之間傳輸記憶體,或 TransferSize 設定為零,則傳回 TRUE;否則傳回 FALSE。若要取得延伸錯誤資訊,請呼叫 GetLastError。

備註

此函式會以 2 MB 分頁為單位,在分割區之間傳輸記憶體。如果 TransferSize 設定為大於零的值,該值會無條件進位到下一個 2 MB 邊界。如果該值設定為零,則不會傳輸任何記憶體,且函式會傳回 TRUE。 在 AnacondaProfiling 模式下,對 XBOX Series X 主機系列或 XBOX Series X|S 主機系列使用進階記憶體模式時,適用下列額外限制:
  • XMemTransferToolsToTitle 只會傳輸 GPU 最佳頻寬記憶體。此功能類似於 XBOX Tools Framework (XTF) 隨附之組態 (xbconfig.exe) 工具中的 ExtraTitleMemory 選項。如需詳細資訊,請參閱組態 (xbconfig.exe)。
  • XMemTransferToolsToSystem 和 XMemTransferTitleToSystem 只會傳輸標準頻寬記憶體。
使用 Lockhart 分析模式時,不支援 XMemTransferToolsToTitle。 如需主機系列記憶體組態的詳細資訊,請參閱為您的遊戲和開發套件設定記憶體。
傳輸到系統的記憶體在多次呼叫 XLaunchNewGame 之間會持續保留。

需求

標頭: xmem.h 程式庫: xmem.lib 支援的平台:XBOX One 系列主機和 XBOX Series 主機

另請參閱

記憶體
XMem
Last modified on October 6, 2026