IDebugEventCallbacks::ChangeDebuggeeState-Methode (dbgeng.h)

Artikel
02/06/2025

Die ChangeDebuggeeState- Rückrufmethode wird vom Modul aufgerufen, wenn Änderungen am Ziel vorgenommen oder erkannt werden.

Syntax

HRESULT ChangeDebuggeeState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Parameter

[in] Flags

Gibt den Typ der am Ziel vorgenommenen Änderungen an. Flags können einen der folgenden Werte annehmen:

Wert	Beschreibung
DEBUG_CDS_ALL	Eine allgemeine Änderung des Ziels ist aufgetreten. Beispielsweise wurde das Ziel ausgeführt, oder das Modul wurde gerade an das Ziel angefügt.
DEBUG_CDS_REGISTERS	Die Prozessorregister für das Ziel wurden geändert.
DEBUG_CDS_DATA	Der Datenbereich des Ziels hat sich geändert.
DEBUG_CDS_REFRESH	Informieren Sie die GUI-Clients, Debuggerfenster zu aktualisieren.

[in] Argument

Stellt zusätzliche Informationen zur Änderung des Ziels bereit. Die Interpretation des Werts des Arguments hängt vom Wert Flagsab:

DEBUG_CDS_ALL

Der Wert Argument ist Null.

DEBUG_CDS_REGISTERS

Wenn sich ein einzelnes Register geändert hat, ist der Wert von Argument der Index dieses Registers. Andernfalls wird der Wert Argument- DEBUG_ANY_ID.

DEBUG_CDS_DATA

Der Wert von Argument gibt an, welcher Datenbereich geändert wurde. Die folgende Tabelle enthält die möglichen Werte von Argument.

Wert	Beschreibung
DEBUG_DATA_SPACE_VIRTUAL	Der virtuelle Speicher des Ziels hat sich geändert.
DEBUG_DATA_SPACE_PHYSICAL	Der physische Speicher des Ziels hat sich geändert.
DEBUG_DATA_SPACE_CONTROL	Der Speicher des Zielsteuerelements wurde geändert.
DEBUG_DATA_SPACE_IO	Die E/A-Ports des Ziels haben Eingabe oder Ausgabe erhalten.
DEBUG_DATA_SPACE_MSR	Die Model-Specific Register (MSRs) des Ziels haben sich geändert.
DEBUG_DATA_SPACE_BUS_DATA	Der Busspeicher des Ziels hat sich geändert.

DEBUG_CDS_REFRESH

Die folgende Tabelle enthält die möglichen Werte von Argument.

Wert
DEBUG_CDS_REFRESH_EVALUATE
DEBUG_CDS_REFRESH_EXECUTE
DEBUG_CDS_REFRESH_EXECUTECOMMANDFILE
DEBUG_CDS_REFRESH_ADDBREAKPOINT
DEBUG_CDS_REFRESH_REMOVEBREAKPOINT
DEBUG_CDS_REFRESH_WRITEVIRTUAL
DEBUG_CDS_REFRESH_WRITEVIRTUALUNCACHED
DEBUG_CDS_REFRESH_WRITEPHYSICAL
DEBUG_CDS_REFRESH_WRITEPHYSICAL2
DEBUG_CDS_REFRESH_SETVALUE
DEBUG_CDS_REFRESH_SETVALUE2
DEBUG_CDS_REFRESH_SETSCOPE
DEBUG_CDS_REFRESH_SETSCOPEFRAMEBYINDEX
DEBUG_CDS_REFRESH_SETSCOPEFROMJITDEBUGINFO
DEBUG_CDS_REFRESH_SETSCOPEFROMSTOREDEVENT
DEBUG_CDS_REFRESH_INLINESTEP
DEBUG_CDS_REFRESH_INLINESTEP_PSEUDO

Rückgabewert

Der Rückgabewert wird vom Modul ignoriert, es sei denn, er gibt einen Remoteprozeduraufruffehler an; in diesem Fall ist der Client, mit dem dieses IDebugEventCallbacks Objekt registriert ist, deaktiviert.

Bemerkungen

Das Modul ruft ChangeDebuggeeState nur auf, wenn das DEBUG_EVENT_CHANGE_DEBUGGEE_STATE Flag in der von IDebugEventCallbacks::GetInterestMaskzurückgegebenen Maske festgelegt ist.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events. Informationen zum Verwalten des Speichers des Ziels, einschließlich Registern und Datenplätzen, finden Sie unter Speicherzugriff. Informationen zum virtuellen und physischen Speicher des Ziels finden Sie unter virtuellen und physischen Speicher. Informationen zum Steuerspeicher, E/A-Ports, MSR und Busspeicher des Ziels finden Sie unter Andere Datenplätze.

Anforderungen

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

Freigeben über