IDebugEventCallbacks::Breakpoint 方法 (dbgeng.h)
當目標發出斷點例外狀況時,引擎會呼叫 斷點 回呼方法。
語法
HRESULT Breakpoint(
[in] PDEBUG_BREAKPOINT Bp
);
參數
[in] Bp
指定與觸發之斷點對應的 IDebugBreakpoint 對象指標。
傳回值
這個方法會傳回 DEBUG_STATUS_XXX 值,指出引擎處理此事件之後,目標的執行應該如何繼續。 如需引擎如何處理此值的詳細資訊,請參閱 監視事件。
言論
如果斷點有相關聯的命令,引擎會在呼叫此方法之前執行該命令。
只有在引擎中有對應至斷點的 IDebugBreakpoint 物件 IDebugBreakpoint,而且--如果斷點是私人斷點,則引擎只會呼叫這個方法--此 IDebugEventCallbacks 物件已向新增斷點的用戶端註冊。
只有在 IDebugEventCallbacks::GetInterestMask傳回的遮罩中設定DEBUG_EVENT_BREAKPOINT旗標時,引擎才會呼叫此方法。
因為引擎會在移除斷點時刪除對應的 IDebugBreakpoint 物件(例如,使用 RemoveBreakpoint),所以在傳回斷 點 之後,Bp 的值可能會無效。 因此,IDebugEventCallbacks 的實作不應該在 斷點 傳回之後 存取 bp。
如需處理事件的詳細資訊,請參閱 監視事件。 如需管理斷點的相關信息,請參閱 斷點。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |