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::ChangeSymbolState The ChangeSymbolState callback method is called by the engine when the symbol state changes.
IDebugEventCallbacks::Exception The Exception callback method is called by the engine when an exceptiondebugging 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::UnloadModule The UnloadModule callback method is called by the engine when a module-unload debugging event occurs in the target.
IDebugEventCallbacks::ChangeDebuggeeState The ChangeDebuggeeState callback method is called by the engine when it makes or detects changes to the target.
IDebugEventCallbacks::CreateProcess The CreateProcess callback method is called by the engine when a create-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::SystemError The SystemError callback method is called by the engine when a system error occurs in the target.
IDebugEventCallbacks::ChangeEngineState The ChangeEngineState callback method is called by the engine when its state has changed.
IDebugEventCallbacks::CreateThread The CreateThread callback method is called by the engine when a create-threaddebugging 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::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.

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)