Edit

IDebugEventCallbacks interface (dbgeng.h)

  • Article

Inheritance

The IDebugEventCallbacks interface inherits from the IUnknown interface. IDebugEventCallbacks also has these types of members:

Methods

The IDebugEventCallbacks interface has these methods.

 
IDebugEventCallbacks::Breakpoint

The Breakpoint callback method is called by the engine when the target issues a breakpoint exception.
IDebugEventCallbacks::ChangeDebuggeeState

The ChangeDebuggeeState callback method is called by the engine when it makes or detects changes to the target. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::ChangeEngineState

The ChangeEngineState callback method is called by the engine when its state has changed. This method belongs to the IDebugEventCallbacks interface.
IDebugEventCallbacks::ChangeSymbolState

The ChangeSymbolState callback method is called by the engine when the symbol state changes. This method belongs to the IDebugEventCallbacks interface.
IDebugEventCallbacks::CreateProcess

The CreateProcess callback method is called by the engine when a create-process debugging event occurs in the target. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::CreateThread

The CreateThread callback method is called by the engine when a create-threaddebugging event occurs in the target. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::Exception

The Exception callback method is called by the engine when an exception debugging event occurs in the target. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::ExitProcess

The ExitProcess callback method is called by the engine when an exit-process debugging event occurs in the target. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::ExitThread

The ExitThread callback method is called by the engine when an exit-thread debugging event occurs in the target. This method belongs to IDebugEventCallbacks.
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. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::SessionStatus

The SessionStatus callback method is called by the engine when a change occurs in the debugger session. This method belongs to IDebugEventCallbacks.
IDebugEventCallbacks::SystemError

The SystemError callback method is called by the engine when a system error occurs in the target. This method belongs to the IDebugEventCallbacks interface.
IDebugEventCallbacks::UnloadModule

The UnloadModule callback method is called by the engine when a module-unload debugging event occurs in the target. This method belongs to IDebugEventCallbacks.

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

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