IDebugControl3::GetNearInstruction-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetNearInstruction- Methode gibt den Speicherort einer Prozessoranweisung relativ zu einem bestimmten Speicherort zurück.

Syntax

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

Parameter

[in] Offset

Gibt den Speicherort im virtuellen Adressbereich des Prozesses an, von dem aus nach der gewünschten Anweisung gesucht werden soll.

[in] Delta

Gibt die Anzahl der Anweisungen aus Offset- der gewünschten Anweisung an. Wenn Delta- negativ ist, liegt der zurückgegebene Offset vor Offset- (weitere Informationen finden Sie im Abschnitt "Hinweise").

[out] NearOffset

Empfängt den Speicherort im virtuellen Adressbereich des Prozesses der Anweisung, die Delta- Anweisungen entfernt von Offset-ist.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Bei einigen Architekturen wie x86 und x64 kann die Größe einer Anweisung variieren. Wenn Delta- negativ ist, ist bei diesen Architekturen möglicherweise nicht eindeutig der gewünschte Anweisungsspeicherort definiert. In diesem Fall sucht das Debuggermodul von Offset- rückwärts, bis eine Position auftritt, sodass die Delta Anzahl von Anweisungen zwischen diesem Speicherort und Offset-vorhanden ist.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über