IDebugEventCallbacks interface

Methods

The IDebugEventCallbacks interface has these methods.

Method Description
IDebugEventCallbacks::Breakpoint The Breakpoint callback method is called by the engine when the target issues a breakpointexception.
IDebugEventCallbacks::ChangeDebuggeeState The ChangeDebuggeeState callback method is called by the engine when it makes or detects changes to the target.
IDebugEventCallbacks::ChangeEngineState The ChangeEngineState callback method is called by the engine when its state has changed.
IDebugEventCallbacks::ChangeSymbolState The ChangeSymbolState callback method is called by the engine when the symbol state changes.
IDebugEventCallbacks::CreateProcess The CreateProcess callback method is called by the engine when a create-processdebugging event occurs in the target.
IDebugEventCallbacks::CreateThread The CreateThread callback method is called by the engine when a create-threaddebugging event occurs in the target.
IDebugEventCallbacks::Exception The Exception callback method is called by the engine when an exceptiondebugging event occurs in the target.
IDebugEventCallbacks::ExitProcess The ExitProcess callback method is called by the engine when an exit-processdebugging event occurs in the target.
IDebugEventCallbacks::ExitThread The ExitThread callback method is called by the engine when an exit-threaddebugging event occurs in the target.
IDebugEventCallbacks::GetInterestMask The GetInterestMask callback method is called to determine which events the IDebugEventCallbacks object is interested in. The engine calls GetInterestMask when the object is registered with a client by using SetEventCallbacks.
IDebugEventCallbacks::LoadModule The LoadModule callback method is called by the engine when a module-load debugging event occurs in the target.
IDebugEventCallbacks::SessionStatus The SessionStatus callback method is called by the engine when a change occurs in the debugger session.
IDebugEventCallbacks::SystemError The SystemError callback method is called by the engine when a system error occurs in the target.
IDebugEventCallbacks::UnloadModule The UnloadModule callback method is called by the engine when a module-unload debugging event occurs in the target.

Remarks

The IDebugEventCallbacksWide interface includes Unicode versions of these methods; the Unicode methods share the same names as those used by the methods in IDebugEventCallbacks.

The following events are generated by the target.

Flag IDebugEventCallbacksMethod Event Description
DEBUG_EVENT_BREAKPOINT Breakpoint A breakpoint exception occurred in the target.
DEBUG_EVENT_EXCEPTION Exception An exception debugging event occurred in the target.
DEBUG_EVENT_CREATE_THREAD CreateThread A create-thread debugging event occurred in the target.
DEBUG_EVENT_EXIT_THREAD ExitThread An exit-thread debugging event occurred in the target.
DEBUG_EVENT_CREATE_PROCESS CreateProcess A create-process debugging event occurred in the target.
DEBUG_EVENT_EXIT_PROCESS ExitProcess An exit-process debugging event occurred in the target.
DEBUG_EVENT_LOAD_MODULE LoadModule A module-load debugging event occurred in the target.
DEBUG_EVENT_UNLOAD_MODULE UnloadModule A module-unload debugging event occurred in the target.
DEBUG_EVENT_SYSTEM_ERROR SystemError A system error occurred in the target.

The following events are generated by the debugger engine.

Flag IDebugEventCallbacksMethod Description
DEBUG_EVENT_SESSION_STATUS SessionStatus A change has occurred in the session status.
DEBUG_EVENT_CHANGE_DEBUGGEE_STATE ChangeDebuggeeState The engine has made or detected a change in the target status.
DEBUG_EVENT_CHANGE_ENGINE_STATE ChangeEngineState The engine state has changed.
DEBUG_EVENT_CHANGE_SYMBOL_STATE ChangeSymbolState The symbol state has changed.

Requirements

   
Target Platform Windows
Header dbgeng.h (include Dbgeng.h)