IDebugRegisters2::GetInstructionOffset2-Methode (dbgeng.h)

  • Artikel

Die GetInstructionOffset2-Methode gibt den Speicherort der aktuellen Anweisung des aktuellen Threads zurück.

Syntax

HRESULT GetInstructionOffset2(
  [in]  ULONG    Source,
  [out] PULONG64 Offset
);

Parameter

[in] Source

Gibt die abzufragende Registrierungsquelle an.

Die möglichen Werte sind in der folgenden Tabelle aufgeführt.

Wert Quelle registrieren
DEBUG_REGSRC_DEBUGGEE Rufen Sie Registrierungsinformationen vom Ziel ab.
DEBUG_REGSRC_EXPLICIT Ruft Registrierungsinformationen aus dem aktuellen expliziten Registerkontext ab.
DEBUG_REGSRC_FRAME Ruft Registerinformationen aus dem Registerkontext des aktuellen Bereichs ab.
Hinweis Die Stapelentladung garantiert keine genaue Aktualisierung des Registerkontexts, sodass der Registerkontext des Bereichsrahmens möglicherweise nicht in allen Fällen korrekt ist.
 

[out] Offset

Empfängt den Speicherort im virtuellen Adressraum des Prozesses der aktuellen Anweisung des aktuellen Threads.

Rückgabewert

Diese Liste enthält nicht alle fehler, die auftreten können. Eine Liste möglicher Fehler finden Sie unter HRESULT-Werte.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.

Hinweise

Die Bedeutung des Werts, der von dieser Methode zurückgegeben wird, ist architekturabhängig. Insbesondere für einen Itanium-basierten Prozessor kann die zurückgegebene virtuelle Adresse eine Adresse innerhalb eines Pakets angeben.

Die GetInstructionOffset-Methode führt dieselbe Aufgabe wie diese Methode aus, verwendet jedoch immer das Ziel als Registerquelle.

Eine Übersicht über die IDebugRegisters-Schnittstelle und andere registerbezogene Methoden finden Sie unter Register.

Anforderungen

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

Weitere Informationen

GetInstructionOffset

IDebugRegisters2