(dbgeng.h) IDebugEventContextCallbacks 介面
此介面包含 DEBUG_EVENT_CONTEXT結構 作為每個事件回呼的「內容」參數。 內容結構包含 「ProcessEngineId」、“ThreadEngineId” 和 “FrameEngineId”。 例如,針對斷點事件之類的事件回呼,它會提供斷點叫用所在的進程/線程資訊,而不需要對引擎執行其他呼叫。
此介面支援事件內容回呼,並取代 使用 IDebugClient::SetEventCallbacks 方法。
使用 IDebugClient6::SetEventContextCallbacks 方法,在調試程式用戶端上設定此介面。
繼承
IDebugEventContextCallback 介面繼承自 IUnknown 介面。 IDebugEventContextCallback 也有下列類型的成員:
方法
IDebugEventContextCallbacks 介面具有這些方法。
IDebugEventContextCallbacks::Breakpoint 當收到斷點例外狀況,而且可以對應至現有的斷點時,就會產生斷點事件。 |
IDebugEventContextCallbacks::ChangeDebuggeeState 偵錯狀態,例如緩存器或數據空間已變更。 |
IDebugEventContextCallbacks::ChangeEngineState 引擎狀態已變更。 |
IDebugEventContextCallbacks::ChangeSymbolState 符號狀態已變更。 |
IDebugEventContextCallbacks::CreateProcess 當目標中發生建立進程偵錯事件時,引擎會呼叫 IDebugEventContextCallbacks::CreateProcess 回呼方法。 |
IDebugEventContextCallbacks::CreateThread 當目標中發生 create-threaddebugging 事件時,引擎會呼叫 IDebugEventContextCallbacks::CreateThread 回呼方法。 |
IDebugEventContextCallbacks::Exception 當目標發生例外狀況偵錯事件時,引擎會呼叫 IDebugEventContextCallbacks::Exception 回呼方法。 |
IDebugEventContextCallbacks::ExitProcess 當目標發生結束進程偵錯事件時,引擎會呼叫 IDebugEventContextCallbacks::ExitProcess 回呼方法。 |
IDebugEventContextCallbacks::ExitThread 當目標發生結束線程偵錯事件時,引擎會呼叫 IDebugEventContextCallbacks::ExitThread 回呼方法。 |
IDebugEventContextCallbacks::GetInterestMask 當為客戶端設定事件回呼時,引擎會呼叫 GetInterestMask 一次。 |
IDebugEventContextCallbacks::LoadModule 當模組載入偵錯事件發生於目標時,引擎會呼叫 IDebugEventContextCallbacks::LoadModule 回呼方法。 |
IDebugEventContextCallbacks::QueryInterface 標準 COM QueryInterface 方法。 |
IDebugEventContextCallbacks::Release 標準 COM Release 方法。 |
IDebugEventContextCallbacks::SessionStatus 會話狀態與其他等候回呼一樣同步,但會呼叫為會話的狀態正在變更,而不是在特定事件中變更,因此其傳回值不會影響等候。 |
IDebugEventContextCallbacks::SystemError 當目標發生系統錯誤時,引擎會呼叫 SystemError 回呼方法。 這個方法屬於 IDebugEventContextCallbacks。 |
IDebugEventContextCallbacks::UnloadModule 當模組卸除偵錯事件發生於目標時,引擎會呼叫 IDebugEventContextCallbacks::UnloadModule 回呼方法。 |
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | dbgeng.h (包含 Dbgeng.h) |