IDebugEventContextCallbacks-Schnittstelle (dbgeng.h)
Diese Schnittstelle enthält eine DEBUG_EVENT_CONTEXT-Struktur als "context"-Parameter für jeden Ereignisrückruf. Die Kontextstruktur enthält die "ProcessEngineId", "ThreadEngineId" und "FrameEngineId". Für ein Ereignisrückruf wie ein Breakpointereignis stellt es beispielsweise Informationen darüber bereit, auf welchen Prozess/Thread der Haltepunkt eingeschlagen wird, ohne dass zusätzliche Aufrufe an die Engine ausgeführt werden müssen.
Diese Schnittstelle unterstützt Ereigniskontextrückrufe und ersetzt die Verwendung der IDebugClient::SetEventCallbacks-Methode .
Legen Sie diese Schnittstelle auf einem Debuggerclient fest, indem Sie die IDebugClient6::SetEventContextCallbacks-Methode verwenden.
Vererbung
Die IDebugEventContextCallback-Schnittstelle erbt von der IUnknown-Schnittstelle . IDebugEventContextCallback verfügt auch über folgende Arten von Membern:
Methoden
Die IDebugEventContextCallbacks-Schnittstelle verfügt über diese Methoden.
| IDebugEventContextCallbacks::Breakpoint Ein Breakpointereignis wird generiert, wenn eine Breakpoint-Ausnahme empfangen wird, und es kann einem vorhandenen Haltepunkt zugeordnet werden. |
| IDebugEventContextCallbacks::ChangeDebuggeeState Der Debuggee-Zustand, z. B. Register oder Datenräume, hat sich geändert. |
| IDebugEventContextCallbacks::ChangeEngineState Der Engine-Zustand hat sich geändert. |
| IDebugEventContextCallbacks::ChangeSymbolState Der Symbolstatus hat sich geändert. |
| IDebugEventContextCallbacks::CreateProcess Die IDebugEventContextCallbacks::CreateProcess-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Create-Process-Debugereignis auftritt. |
| IDebugEventContextCallbacks::CreateThread Die IDebugEventContextCallbacks::CreateThread-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein create-threaddebugging-Ereignis auftritt. |
| IDebugEventContextCallbacks::Exception Die IDebugEventContextCallbacks::Exception-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Ausnahmedebuggingereignis auftritt. |
| IDebugEventContextCallbacks::ExitProcess Die IDebugEventContextCallbacks::ExitProcess-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Exit-Process-Debugereignis auftritt. |
| IDebugEventContextCallbacks::ExitThread Die IDebugEventContextCallbacks::ExitThread-Rückrufmethode wird von der Engine aufgerufen, wenn ein Exit-Thread-Debugereignis im Ziel auftritt. |
| IDebugEventContextCallbacks::GetInterestMask Die Engine ruft GetInterestMask einmal auf, wenn die Ereignisrückrufe für einen Client festgelegt werden. |
| IDebugEventContextCallbacks::LoadModule Die IDebugEventContextCallbacks::LoadModule-Rückrufmethode wird von der Engine aufgerufen, wenn ein Modulladedebuggingereignis im Ziel auftritt. |
| IDebugEventContextCallbacks::QueryInterface Die COM QueryInterface-Standardmethode. |
| IDebugEventContextCallbacks::Release Die COM Release-Standardmethode. |
| IDebugEventContextCallbacks::SessionStatus Sitzungs-status ist synchron wie die anderen Warterückrufe, wird jedoch aufgerufen, da sich der Zustand der Sitzung ändert und nicht bei bestimmten Ereignissen, sodass der Rückgabewert keinen Einfluss auf das Warten hat. |
| IDebugEventContextCallbacks::SystemError Die SystemError-Rückrufmethode wird von der Engine aufgerufen, wenn ein Systemfehler im Ziel auftritt. Diese Methode gehört zu IDebugEventContextCallbacks. |
| IDebugEventContextCallbacks::UnloadModule Die IDebugEventContextCallbacks::UnloadModule-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Debugereignis zum Entladen des Moduls auftritt. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | dbgeng.h (einschließlich Dbgeng.h) |