Pular para o conteúdo principal

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

Mapeia páginas usando uma matriz run-length de tokens.

Sintaxe

Parâmetros

pMapping   _Inout_
Tipo: XGMemoryLayoutMapping *
O resultado do mapeamento atualizado como um ponteiro para uma estrutura XGMemoryLayoutMapping. pTokens   _In_reads_(TokenCount)
Tipo: USHORT*
A matriz run-length de tokens. TokenCount   
Tipo: UINT32
O número de tokens na matriz run-length de tokens. Cada token representa um bloco de páginas ESRAM ou do sistema. PageCount   
Tipo: UINT32
O número total de páginas na matriz run-length de tokens, incluindo páginas do sistema e páginas ESRAM. Essa contagem ajustará a matriz run-length decodificada em comprimento e/ou uso de ESRAM. Se a matriz run-length decodificada 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. MaxEsramPageCount
Tipo: UINT32
O número máximo de páginas ESRAM na matriz run-length de tokens. Essa contagem ajustará a matriz run-length decodificada em comprimento e/ou uso de ESRAM. Se a matriz run-length decodificada 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.

Valor retornado

Tipo: HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Comentários

Este método mapeia páginas usando uma matriz run-length de tokens. Cada token representa um bloco de páginas ESRAM ou do sistema; para obter detalhes, consulte as macros #define EsramToken e SystemToken em xgmemory.h. O mapeamento é criado com uma contagem de páginas específica e uma contagem máxima de páginas ESRAM. Essas contagens ajustarão a matriz run-length decodificada em comprimento e/ou uso de ESRAM. Se a matriz run-length decodificada 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
Última modificação em 6 de outubro de 2026