Pular para o conteúdo principal

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

Mapeia páginas usando um padrão predefinido passado como uma matriz de bytes.

Sintaxe

Parâmetros

pMapping   _Inout_
Tipo: XGMemoryLayoutMapping *
O resultado do mapeamento atualizado como um ponteiro para uma estrutura XGMemoryLayoutMapping. PageCount   
Tipo: UINT32
O número de páginas com as quais criar este mapeamento, incluindo páginas ESRAM e páginas do sistema. Essa contagem ajustará o padrão em comprimento e/ou uso de ESRAM. Se o padrão 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 PageCount. pPattern   _In_reads_(PatternSizeBytes)
Tipo: BYTE*
O padrão predefinido, como uma matriz de bytes. PatternSizeBytes   
Tipo: SIZE_T
O tamanho do padrão predefinido. MaxEsramPageCount   
Tipo: UINT32
O número máximo de páginas ESRAM com as quais o mapeamento deve ser criado. Essa contagem ajustará o padrão em comprimento e/ou uso de ESRAM. Se o padrão 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 MaxEsramPageCount.

Valor retornado

Tipo: HRESULT S_OK, E_INVALIDARG ou E_OUTOFMEMORY.

Comentários

O mapeamento é criado com uma contagem de páginas específica e uma contagem máxima de páginas ESRAM. Essas contagens ajustarão o padrão em comprimento e/ou uso de ESRAM. Se o padrão 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