IDebugControl::GetNearInstruction-Methode (dbgeng.h)

Artikel
08/07/2023

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 Adressraum 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, befindet sich der zurückgegebene Offset vor Offset (weitere Informationen finden Sie im Abschnitt Hinweise).

[out] NearOffset

Empfängt den Speicherort im virtuellen Adressraum des Prozesses der Anweisung , die Deltaanweisungen entfernt von Offset ist.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

In einigen Architekturen, z. B. x86 und x64, kann die Größe einer Anweisung variieren. Wenn Delta in diesen Architekturen negativ ist, ist der gewünschte Anweisungsspeicherort möglicherweise nicht eindeutig definiert. In diesem Fall sucht die Debugger-Engine rückwärts von Offset aus, bis sie auf einen Speicherort stößt, sodass die Delta-Anzahl von Anweisungen zwischen diesem Speicherort und Offset vorhanden ist.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Freigeben über