Partilhar via


Método IDebugSymbols2::GetModuleByOffset (dbgeng.h)

O método GetModuleByOffset pesquisa por meio dos módulos de do destino para um cuja alocação de memória inclui o local especificado.

Sintaxe

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parâmetros

[in] Offset

Especifica um local no espaço de endereço virtual do destino que está dentro da alocação de memória do módulo desejado, por exemplo, o endereço de um símbolo que pertence ao módulo.

[in] StartIndex

Especifica o índice do qual começar a pesquisar.

[out, optional] Index

Recebe o índice do módulo. Se de índice for NULL, essas informações não serão retornadas.

[out, optional] Base

Recebe o local no espaço de endereço de memória do destino da base do módulo. Se Base 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.

Observações

A partir do índice especificado, esse método retorna o primeiro módulo encontrado cujo intervalo de endereços de alocação de memória inclui o local especificado. Se o destino tiver mais de um módulo cujo intervalo de endereços de memória inclui esse local, os módulos subsequentes poderão ser encontrados por chamadas repetidas para esse método com valores mais altos de StartIndex.

Para obter mais informações sobre módulos, consulte Modules.

Requisitos

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

Consulte também

GetModuleByIndex

GetModuleByOffset2

IDebugSymbols

IDebugSymbols2

IDebugSymbols3