Método IDebugDataSpaces4::GetVirtualTranslationPhysicalOffsets (dbgeng.h)

Artigo
02/06/2025

O método GetVirtualTranslationPhysicalOffsets retorna os endereços físicos das estruturas de paginação do sistema em diferentes níveis da hierarquia de paginação.

Sintaxe

HRESULT GetVirtualTranslationPhysicalOffsets(
  [in]            ULONG64  Virtual,
  [out, optional] PULONG64 Offsets,
  [in]            ULONG    OffsetsSize,
  [out, optional] PULONG   Levels
);

Parâmetros

[in] Virtual

Especifica o local no espaço de endereço virtual do destino a ser convertido.

[out, optional] Offsets

Recebe os endereços físicos das estruturas de paginação do sistema. Se estiver definido como NULL, essas informações não serão retornadas.

[in] OffsetsSize

Especifica o número de elementos que a matriz deslocamentos contém. Esse é o número máximo de endereços que serão retornados.

[out, optional] Levels

Recebe o número de níveis na hierarquia de paginação do endereço especificado. Se for NULL, essas informações não serão retornadas.

Valor de retorno

Esse método também pode retornar valores de erro. Consulte de Valores Retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
HRESULT_FROM_NT(STATUS_NO_PAGEFILE)	Nenhuma página física que contenha o endereço especificado foi encontrada.

Observações

Esse método só está disponível na depuração no modo kernel.

Traduzir um endereço virtual para um endereço físico requer que o Windows perdoe a hierarquia de paginação. Em cada nível, ele lê informações de paginação da memória física. Esse método retorna os deslocamentos dessas páginas físicas. O número de níveis na hierarquia de paginação pode ser diferente para endereços diferentes.

O endereço no último nível da hierarquia é o endereço físico correspondente ao endereço virtual especificado. Isso é o que VirtualToPhysical retornaria.

Para obter detalhes sobre como os endereços virtuais são traduzidos em endereços físicos, consulte Microsoft Windows Internals por David Solomon e Mark Russinovich.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Compartilhar via