IDebugEventCallbacksWide::ChangeEngineState-Methode (dbgeng.h)

Artikel
02/06/2025

Die ChangeEngineState- Rückrufmethode wird vom Modul aufgerufen, wenn sich der Status geändert hat.

Syntax

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

Parameter

[in] Flags

Gibt einen Bitsatz an, der den Typ der Änderungen angibt, die im Zustand des Moduls aufgetreten sind. Die folgenden Bitkennzeichnungen können festgelegt werden:

Wert	Beschreibung
DEBUG_CES_CURRENT_THREAD	Der aktuelle Thread hat sich geändert, was bedeutet, dass sich auch das aktuelle Ziel und der aktuelle Prozess geändert haben.
DEBUG_CES_EFFECTIVE_PROCESSOR	Der effektive Prozessor hat sich geändert.
DEBUG_CES_BREAKPOINTS	Mindestens ein Haltepunkte geändert haben.
DEBUG_CES_CODE_LEVEL	Die Codeinterpretationsebene hat sich geändert.
DEBUG_CES_EXECUTION_STATUS	Der Ausführungsstatus wurde geändert.
DEBUG_CES_ENGINE_OPTIONS	Die Moduloptionen wurden geändert.
DEBUG_CES_LOG_FILE	Die Protokolldatei wurde geöffnet oder geschlossen.
DEBUG_CES_RADIX	Der Standardradiix hat sich geändert.
DEBUG_CES_EVENT_FILTERS	Die Ereignisfilter wurden geändert.
DEBUG_CES_PROCESS_OPTIONS	Die Prozessoptionen für den aktuellen Prozess wurden geändert.
DEBUG_CES_EXTENSIONS	Erweiterungs-DLLs wurden geladen oder entladen. (Weitere Informationen finden Sie unter Laden von Debuggererweiterungs-DLLs.)
DEBUG_CES_SYSTEMS	Ein Ziel wurde hinzugefügt oder entfernt.
DEBUG_CES_ASSEMBLY_OPTIONS	Die Assemble-Optionen wurden geändert.
DEBUG_CES_EXPRESSION_SYNTAX	Die Standardausdrucksyntax wurde geändert.
DEBUG_CES_TEXT_REPLACEMENTS	Textersetzungen wurden geändert.

[in] Argument

Enthält zusätzliche Informationen zur Änderung des Modulzustands. Wenn mehr als ein Bit-Flag im parameter Flags festgelegt ist, wird der parameter Argument nicht verwendet. Andernfalls hängt die Interpretation des Werts Argument vom Wert Flagsab:

DEBUG_CES_CURRENT_THREAD

Der Wert von Argument ist die aktuelle Modulthread-ID oder -, wenn kein aktueller Thread vorhanden ist--DEBUG_ANY_ID. Weitere Informationen finden Sie unter Threads und Prozesse.

DEBUG_CES_EFFECTIVE_PROCESSOR

Der Wert von Argument ist der Typ des effektiven Prozessors.

DEBUG_CES_BREAKPOINTS

Der Wert von Argument ist die Haltepunkt-ID des Haltepunkts, der geändert wurde oder - wenn mehrere Haltepunkte geändert wurden --DEBUG_ANY_ID. Weitere Informationen finden Sie unter Haltepunkte.

DEBUG_CES_CODE_LEVEL

Der Wert Argument ist die Codeinterpretationsebene.

DEBUG_CES_EXECUTION_STATUS

Der Wert Argument- ist der Ausführungsstatus (wie im Thema DEBUG_STATUS_XXX beschrieben) möglicherweise mit der Bitkennzeichnung DEBUG_STATUS_INSIDE_WAIT kombiniert. DEBUG_STATUS_INSIDE_WAIT wird festgelegt, wenn ein WaitForEvent-aufruf aussteht. Weitere Informationen finden Sie unter Debugging Session and Execution Model.

DEBUG_CES_ENGINE_OPTIONS

Der Wert Argument ist die Moduloptionen.

DEBUG_CES_LOG_FILE

Der Wert Argument- ist TRUE, wenn die Protokolldatei geöffnet wurde, und FALSE, wenn die Protokolldatei geschlossen wurde.

DEBUG_CES_RADIX

Der Wert von Argument ist der Standardradiix.

DEBUG_CES_EVENT_FILTERS

Der Wert von Argument ist der Index des Ereignisfilters, der geändert wurde oder - wenn mehrere Ereignisfilter geändert wurden --DEBUG_ANY_ID.

DEBUG_CES_PROCESS_OPTIONS

Der Wert von Argument ist die Prozessoptionen für den aktuellen Prozess.

DEBUG_CES_EXTENSIONS

Der Wert Argument ist Null.

DEBUG_CES_SYSTEMS

Der Wert Argument- ist die Ziel-ID des Ziels, das hinzugefügt wurde, oder - wenn ein Ziel entfernt wurde --DEBUG_ANY_ID.

DEBUG_CES_ASSEMBLE_OPTIONS

Der Wert Argument- ist die Assemble-Optionen.

DEBUG_CES_EXPRESSION_SYNTAX

Der Wert von Argument ist die Standardausdrucksyntax.

DEBUG_CES_TEXT_REPLACEMENTS

Der Wert Argument- ist DEBUG_ANY_ID.

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 IDebugEventCallbacksWide-Objekt registriert ist, deaktiviert.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_CHANGE_ENGINE_STATE Flag in der Maske festgelegt wird, die von IDebugEventCallbacksWide::GetInterestMaskzurückgegeben wird.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events.

Anforderungen

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

Freigeben über