Skip to main content

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

使用語彙基元的執行長度陣列來對應頁面。

語法

參數

pMapping   _Inout_
類型: XGMemoryLayoutMapping *
更新後的對應結果,以指向 XGMemoryLayoutMapping 結構的指標表示。 pTokens   _In_reads_(TokenCount)
類型: USHORT*
語彙基元的執行長度陣列。 TokenCount   
類型: UINT32
語彙基元執行長度陣列中的語彙基元數目。每個語彙基元代表一個 ESRAM 或系統頁面區塊。 PageCount   
類型: UINT32
語彙基元執行長度陣列中的頁面總數,包括系統頁面和 ESRAM 頁面。此計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大,無法涵蓋整個對應,則會使用系統頁面填補至對應的結尾。 如果 PageCount 為 XG_ALL_REMAINING_PAGES,則會以 XGMemoryLayout::GetPageCountRemaining 取代。 MaxEsramPageCount
類型: UINT32
語彙基元執行長度陣列中的 ESRAM 頁面數目上限。此計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大,無法涵蓋整個對應,則會使用系統頁面填補至對應的結尾。 如果 MaxEsramPageCount 為 XG_ALL_REMAINING_PAGES,則會以 XGMemoryLayout::GetFreeEsramPageCount 取代。

傳回值

類型: HRESULT S_OK、E_INVALIDARG 或 E_OUTOFMEMORY。

備註

此方法使用語彙基元的執行長度陣列來對應頁面。每個語彙基元代表一個 ESRAM 或系統頁面區塊;如需詳細資料,請參閱 xgmemory.h 中的 EsramToken 和 SystemToken #define 巨集。 對應會以特定的頁面計數和 ESRAM 頁面計數上限建立。這些計數會調整解碼後執行長度陣列的長度和/或 ESRAM 使用量。如果解碼後的執行長度陣列不夠大,無法涵蓋整個對應,則會使用系統頁面填補至對應的結尾。

需求

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

另請參閱

XGMemoryLayout
Last modified on October 6, 2026