IDebugEventCallbacksWide::ChangeDebuggeeState-Methode (dbgeng.h)

Artikel
02/23/2024

Die ChangeDebuggeeState-Rückrufmethode wird von der Engine 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 Änderungen an, die am Ziel vorgenommen wurden. 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 die Engine wurde gerade an das Ziel angefügt.
DEBUG_CDS_REGISTERS	Das Register des Prozessors für das Ziel wurde geändert.
DEBUG_CDS_DATA	Der Datenbereich des Ziels hat sich geändert.

[in] Argument

Stellt zusätzliche Informationen zur Änderung des Ziels bereit. Die Interpretation des Werts von Argument hängt vom Wert von Flags ab:

DEBUG_CDS_ALL

Der Wert von Argument ist null.

DEBUG_CDS_REGISTERS

Wenn sich ein einzelnes Register geändert hat, ist der Wert von Argument der Index dieses Registers. Andernfalls ist der Wert von 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 Arbeitsspeicher des Ziels wurde geändert.
DEBUG_DATA_SPACE_PHYSICAL	Der physische Arbeitsspeicher des Ziels wurde geändert.
DEBUG_DATA_SPACE_CONTROL	Der Steuerungsspeicher des Ziels wurde geändert.
DEBUG_DATA_SPACE_IO	Die E/A-Ports des Ziels haben eine Eingabe oder Ausgabe empfangen.
DEBUG_DATA_SPACE_MSR	Die Model-Specific Register (MSRs) des Ziels wurden geändert.
DEBUG_DATA_SPACE_BUS_DATA	Der Busspeicher des Ziels wurde geändert.

Rückgabewert

Der Rückgabewert wird von der Engine ignoriert, es sei denn, er weist auf einen Remoteprozeduraufruffehler hin. In diesem Fall ist der Client, bei dem dieses IDebugEventCallbacksWide-Objekt registriert ist, deaktiviert.

Hinweise

Die Engine ruft ChangeDebuggeeState nur auf, wenn das DEBUG_EVENT_CHANGE_DEBUGGEE_STATE-Flag in der von IDebugEventCallbacksWide::GetInterestMask zurückgegebenen Maske festgelegt ist.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen. Informationen zum Verwalten des Speichers des Ziels, einschließlich Registern und Datenbereichen, finden Sie unter Arbeitsspeicherzugriff. Informationen zum virtuellen und physischen Arbeitsspeicher des Ziels finden Sie unter Virtueller und physischer Arbeitsspeicher. Informationen zum Steuerungsspeicher, E/A-Ports, MSR und Busspeicher des Ziels finden Sie unter Andere Datenräume.

Anforderungen

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

Freigeben über