Metodo IDebugControl::GetNearInstruction (dbgeng.h)

  • Articolo

Il metodo GetNearInstruction restituisce la posizione di un'istruzione del processore rispetto a una determinata posizione.

Sintassi

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

Parametri

[in] Offset

Specifica la posizione nello spazio indirizzi virtuale del processo da cui iniziare a cercare l'istruzione desiderata.

[in] Delta

Specifica il numero di istruzioni da Offset dell'istruzione desiderata. Se Delta è negativo, l'offset restituito è precedente a Offset (vedere la sezione Osservazioni per altre informazioni).

[out] NearOffset

Riceve la posizione nello spazio indirizzi virtuale del processo dell'istruzione che indica le istruzioni Delta lontano da Offset.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere Valori restituiti .

Codice restituito Descrizione
S_OK
 Il metodo è stato eseguito correttamente.

Commenti

In alcune architetture, ad esempio x86 e x64, le dimensioni di un'istruzione possono variare. In queste architetture, quando Delta è negativo, la posizione desiderata dell'istruzione potrebbe non essere definita in modo univoco. In questo caso, il motore del debugger eseguirà la ricerca all'indietro da Offset fino a quando non rileva una posizione in modo che vi sia il numero delta di istruzioni tra tale posizione e Offset.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione dbgeng.h (include Dbgeng.h)