Método XGMemoryLayout::MapPagePriorityArray (família XBOX One)

Mapeia páginas usando uma matriz de prioridade de páginas.

Sintaxe

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

Parâmetros

pMapping   _Inout_
Tipo: XGMemoryLayoutMapping * [in, out] O resultado do mapeamento atualizado como um ponteiro para uma estrutura XGMemoryLayoutMapping. pPagePriorityValues   _In_reads_(PagePriorityCount)
Tipo: UINT32* [in] Os valores de prioridade na matriz de prioridade de páginas. PagePriorityCount
Tipo: UINT32 O número de entradas de prioridade de página. PageCount
Tipo: UINT32 O número total de páginas na matriz de prioridade de páginas, incluindo páginas do sistema e páginas ESRAM. Essa contagem ajustará o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento. Se PageCount for XG_ALL_REMAINING_PAGES, então XGMemoryLayout::GetPageCountRemaining é usado no lugar como o valor de PageCount. MaxEsramPageCount
Tipo: UINT32 O número máximo de páginas ESRAM na matriz de prioridade de páginas. Essa contagem ajustará o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento. Se MaxEsramPageCount for XG_ALL_REMAINING_PAGES, então XGMemoryLayout::GetFreeEsramPageCount é usado no lugar como o valor de MaxEsramPageCount.

Valor retornado

Tipo: HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Comentários

Este método mapeia páginas usando uma matriz de prioridade de páginas. Cada valor na matriz de prioridade de páginas corresponde a uma página, organizada de acordo com o endereço virtual. Os valores são definidos pelo usuário, e valores maiores indicam prioridade mais alta. Antes de o mapeamento ser aplicado, a contagem máxima de páginas ESRAM é convertida em um valor mínimo de prioridade. Todos os valores de prioridade da matriz maiores ou iguais ao valor mínimo de prioridade são mapeados usando páginas ESRAM. A conversão de uma contagem máxima de páginas ESRAM em um valor mínimo de prioridade é uma operação O(n log n) sobre a contagem de páginas do mapeamento. O mapeamento é criado com a contagem de páginas especificada e a contagem máxima de páginas ESRAM. Essas contagens ajustarão o mapeamento em comprimento e/ou uso de ESRAM. Se a matriz de valores de prioridade de página não for grande o suficiente para abranger todo o mapeamento, páginas do sistema serão usadas para preencher até o final do mapeamento.

Requisitos

Cabeçalho: xgmemory.h Plataformas compatíveis: família XBOX One

Confira também

XGMemoryLayout

(all) API references

Error codes

Audio API reference

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

MapPagePriorityArray (família XBOX One)

Método XGMemoryLayout::MapPagePriorityArray (família XBOX One)

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

​Método XGMemoryLayout::MapPagePriorityArray (família XBOX One)

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

Método XGMemoryLayout::MapPagePriorityArray (família XBOX One)

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também