Metodo IDebugControl::GetNearInstruction (dbgeng.h)

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 .

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