IDebugEventContextCallbacks 介面 (dbgeng.h)
此介面包含 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 回呼方法。 |
要求
要求 | 價值 |
---|---|
目標平臺 | 窗戶 |
標頭 | dbgeng.h (include Dbgeng.h) |