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

Artigo
02/06/2025

O método GetNearInstruction retorna o local de uma instrução de 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 de Deslocamento da instrução desejada. Se Delta for negativo, o deslocamento retornado será antes de de Deslocamento (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á instruções delta longe de de deslocamento.

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

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

Requisitos

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

Partilhar via