Metodo IDebugControl::GetNearInstruction (dbgeng.h)

Articolo
02/06/2025

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 offset dell'istruzione desiderata. Se Delta è negativo, l'offset restituito è prima di offset (vedere la sezione Osservazioni per altre informazioni).

[out] NearOffset

Riceve la posizione nello spazio indirizzi virtuale del processo dell'istruzione 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 ha avuto esito positivo.

Osservazioni

In alcune architetture, ad esempio x86 e x64, le dimensioni di un'istruzione possono variare. In queste architetture, quando delta è negativo, il percorso dell'istruzione desiderato potrebbe non essere definito in modo univoco. In questo caso, il motore del debugger eseguirà la ricerca all'indietro da Offset finché non rileva una posizione in modo che esista il numero di istruzioni delta tra tale posizione e offset .

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite