Método IDebugControl::GetNearInstruction (dbgeng.h)

O método GetNearInstruction retorna o local de uma instrução do processador em relação a um determinado local.

Sintaxe

HRESULT GetNearInstruction(
  [in]  ULONG64  Offset,
  [in]  LONG     Delta,
  [out] PULONG64 NearOffset
);

Parâmetros

[in] Offset

Especifica o local no espaço de endereço virtual do processo do qual começar a procurar a instrução desejada.

[in] Delta

Especifica o número de instruções de Deslocamento da instrução desejada. Se Delta for negativo, o deslocamento retornado será antes de Offset (consulte a seção Comentários para obter mais informações).

[out] NearOffset

Recebe o local no espaço de endereço virtual do processo da instrução que está as instruções Delta longe de Offset.

Retornar valor

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

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

Comentários

Em algumas arquiteturas, como x86 e x64, o tamanho de uma instrução pode variar. Nessas arquiteturas, quando o Delta é negativo, o local de instrução desejado pode não ser definido exclusivamente. Nesse caso, o mecanismo de depurador pesquisará para trás em Deslocamento até encontrar um local de modo que haja o número Delta de instruções entre esse local e Deslocamento.

Requisitos

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