IDebugEventContextCallbacks interface (dbgeng.h)
This interface includes a DEBUG_EVENT_CONTEXT structure as the “context” parameter of each event callback. The context structure contains the “ProcessEngineId”, “ThreadEngineId”, and “FrameEngineId”. For example, for an event callbacks like a breakpoint event, it provides information on which process/thread the breakpoint hit on without having to do additional calls back into the engine.
This interface supports event context callbacks and replaces the use of the IDebugClient::SetEventCallbacks method.
Set this interface on a debugger client by using the IDebugClient6::SetEventContextCallbacks method.
Inheritance
The IDebugEventContextCallback interface inherits from the IUnknown interface. IDebugEventContextCallback also has these types of members:
Methods
The IDebugEventContextCallbacks interface has these methods.
| IDebugEventContextCallbacks::Breakpoint A breakpoint event is generated when a breakpoint exception is received and it can be mapped to an existing breakpoint. |
| IDebugEventContextCallbacks::ChangeDebuggeeState Debuggee state, such as registers or data spaces, has changed. |
| IDebugEventContextCallbacks::ChangeEngineState The engine state has changed. |
| IDebugEventContextCallbacks::ChangeSymbolState The symbol state has changed. |
| IDebugEventContextCallbacks::CreateProcess The IDebugEventContextCallbacks::CreateProcess callback method is called by the engine when a create-process debugging event occurs in the target. |
| IDebugEventContextCallbacks::CreateThread The IDebugEventContextCallbacks::CreateThread callback method is called by the engine when a create-threaddebugging event occurs in the target. |
| IDebugEventContextCallbacks::Exception The IDebugEventContextCallbacks::Exception callback method is called by the engine when an exception debugging event occurs in the target. |
| IDebugEventContextCallbacks::ExitProcess The IDebugEventContextCallbacks::ExitProcess callback method is called by the engine when an exit-process debugging event occurs in the target. |
| IDebugEventContextCallbacks::ExitThread The IDebugEventContextCallbacks::ExitThread callback method is called by the engine when an exit-thread debugging event occurs in the target. |
| IDebugEventContextCallbacks::GetInterestMask The engine calls GetInterestMask once when the event callbacks are set for a client. |
| IDebugEventContextCallbacks::LoadModule The IDebugEventContextCallbacks::LoadModule callback method is called by the engine when a module-load debugging event occurs in the target. |
| IDebugEventContextCallbacks::QueryInterface The standard COM QueryInterface method. |
| IDebugEventContextCallbacks::Release The standard COM Release method. |
| IDebugEventContextCallbacks::SessionStatus Session status is synchronous like the other wait callbacks but it is called as the state of the session is changing rather than at specific events so its return value does not influence waiting. |
| IDebugEventContextCallbacks::SystemError The SystemError callback method is called by the engine when a system error occurs in the target. This method belongs to IDebugEventContextCallbacks. |
| IDebugEventContextCallbacks::UnloadModule The IDebugEventContextCallbacks::UnloadModule callback method is called by the engine when a module-unload debugging event occurs in the target. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | dbgeng.h (include Dbgeng.h) |