Skip to main content

XGMemoryLayout::MapFromPattern 方法 (XBOX One 系列)

使用以位元組陣列傳遞的預先定義模式來對應頁面。

語法

參數

pMapping   _Inout_
類型: XGMemoryLayoutMapping *
更新後的對應結果,以指向 XGMemoryLayoutMapping 結構的指標表示。 PageCount   
類型: UINT32
用來建立此對應的頁面數目,包括 ESRAM 頁面和系統頁面。此計數會調整模式的長度和/或 ESRAM 使用量。如果模式不夠大,無法涵蓋整個對應,則會使用系統頁面填補至對應的結尾。 如果 PageCount 為 XG_ALL_REMAINING_PAGES,則會以 XGMemoryLayout::GetPageCountRemaining 取代作為 PageCount。 pPattern   _In_reads_(PatternSizeBytes)
類型: BYTE*
預先定義的模式,以位元組陣列表示。 PatternSizeBytes   
類型: SIZE_T
預先定義模式的大小。 MaxEsramPageCount   
類型: UINT32
用來建立對應的 ESRAM 頁面數目上限。此計數會調整模式的長度和/或 ESRAM 使用量。如果模式不夠大,無法涵蓋整個對應,則會使用系統頁面填補至對應的結尾。 如果 MaxEsramPageCount 為 XG_ALL_REMAINING_PAGES,則會以 XGMemoryLayout::GetFreeEsramPageCount 取代作為 MaxEsramPageCount。

傳回值

類型: HRESULT S_OK、E_INVALIDARG 或 E_OUTOFMEMORY。

備註

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

需求

標頭: xgmemory.h 支援的平台: XBOX One 系列

另請參閱

XGMemoryLayout
Last modified on October 6, 2026