Metodo IDebugControl2::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 il percorso 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 è prima di Offset (vedere la sezione Osservazioni per altre informazioni).

[out] NearOffset

Riceve il percorso nello spazio indirizzi virtuale del processo dell'istruzione che è le istruzioni Delta lontano da Offset.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, 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 di istruzione desiderata potrebbe non essere definita in modo univoco. In questo caso, il motore del debugger cercherà indietro da Offset fino a quando non rileva una posizione in modo che esista il numero di istruzioni tra tale posizione e Offset.

Requisiti

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