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