IDebugControl2::GetNearInstruction-Methode (dbgeng.h)

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 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.

Hinweise

Bei einigen Architekturen wie x86 und x64 kann die Größe einer Anweisung variieren. Wenn Delta in diesen Architekturen negativ ist, ist der gewünschte Befehlsspeicherort 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 zwischen diesem Speicherort und Offset die Delta-Anzahl von Anweisungen vorhanden ist.

Anforderungen

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