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

使用頁面優先順序陣列來對應頁面。

語法

HRESULT MapPagePriorityArray(
         XGMemoryLayoutMapping *pMapping,
         const UINT32 *pPagePriorityValues,
         UINT32 PagePriorityCount,
         UINT32 PageCount,
         UINT32 MaxEsramPageCount
)  

參數

pMapping   _Inout_
類型: XGMemoryLayoutMapping * [in, out] 更新後的對應結果，以指向 XGMemoryLayoutMapping 結構的指標表示。 pPagePriorityValues   _In_reads_(PagePriorityCount)
類型: UINT32* [in] 頁面優先順序陣列中的優先順序值。 PagePriorityCount
類型: UINT32 頁面優先順序項目的數目。 PageCount
類型: UINT32 頁面優先順序陣列中的頁面總數，包括系統頁面和 ESRAM 頁面。此計數會調整對應的長度和/或 ESRAM 使用量。如果頁面優先順序值陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。如果 PageCount 為 XG_ALL_REMAINING_PAGES，則會以 XGMemoryLayout::GetPageCountRemaining 取代作為 PageCount 的值。 MaxEsramPageCount
類型: UINT32 頁面優先順序陣列中的 ESRAM 頁面數目上限。此計數會調整對應的長度和/或 ESRAM 使用量。如果頁面優先順序值陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。如果 MaxEsramPageCount 為 XG_ALL_REMAINING_PAGES，則會以 XGMemoryLayout::GetFreeEsramPageCount 取代作為 MaxEsramPageCount 的值。

傳回值

類型: HRESULT S_OK、E_INVALIDARG 或 E_OUTOFMEMORY。

備註

此方法使用頁面優先順序陣列來對應頁面。頁面優先順序陣列中的每個值各對應一個頁面，並依虛擬位址排列。值由使用者定義，值越大表示優先順序越高。套用對應之前，ESRAM 頁面計數上限會轉換為最低優先順序值。陣列中任何大於或等於最低優先順序值的優先順序值，都會使用 ESRAM 頁面進行對應。從 ESRAM 頁面計數上限轉換為最低優先順序值，是對對應頁面計數執行的 O(n log n) 作業。對應會以指定的頁面計數和 ESRAM 頁面計數上限建立。這些計數會調整對應的長度和/或 ESRAM 使用量。如果頁面優先順序值陣列不夠大，無法涵蓋整個對應，則會使用系統頁面填補至對應的結尾。

需求

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

另請參閱

XGMemoryLayout

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

MapPagePriorityArray (XBOX One 系列)

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

語法

參數

傳回值

備註

需求

另請參閱

​XGMemoryLayout::MapPagePriorityArray 方法 (XBOX One 系列)

​語法

​參數

​傳回值

​備註

​需求

​另請參閱

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

語法

參數

傳回值

備註

需求

另請參閱