Método IDebugRegisters2::GetInstructionOffset2 (dbgeng.h)

  • Artigo

O método GetInstructionOffset2 retorna o local da instrução atual do thread atual.

Sintaxe

HRESULT GetInstructionOffset2(
  [in]  ULONG    Source,
  [out] PULONG64 Offset
);

Parâmetros

[in] Source

Especifica a origem do registro a ser consultada.

Os valores possíveis são listados na tabela a seguir.

Valor Registrar origem
DEBUG_REGSRC_DEBUGGEE Buscar informações de registro do destino.
DEBUG_REGSRC_EXPLICIT Buscar informações de registro do contexto de registro explícito atual.
DEBUG_REGSRC_FRAME Buscar informações de registro do contexto de registro do escopo atual.
Nota O desenrolamento de pilha não garante a atualização precisa do contexto de registro, portanto, o contexto de registro do quadro de escopo pode não ser preciso em todos os casos.
 

[out] Offset

Recebe o local no espaço de endereço virtual do processo da instrução atual do thread atual.

Retornar valor

Essa lista não contém todos os erros que podem ocorrer. Para obter uma lista de possíveis erros, consulte Valores HRESULT.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.

Comentários

O significado do valor retornado por esse método depende da arquitetura. Em particular, para um processador baseado em Itanium, o endereço virtual retornado pode indicar um endereço dentro de um pacote.

O método GetInstructionOffset executa a mesma tarefa que esse método, mas sempre usa o destino como a origem do registro.

Para obter uma visão geral da interface IDebugRegisters e outros métodos relacionados ao registro, consulte Registros.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua DbgEng.h)

Confira também

GetInstructionOffset

IDebugRegisters2