IDebugEventCallbacks::Breakpoint メソッド (dbgeng.h)

ブレークポイント コールバック メソッドは、ターゲットがブレークポイント例外を発行したときにエンジンによって呼び出されます。

構文

HRESULT Breakpoint(
  [in] PDEBUG_BREAKPOINT Bp
);

パラメーター

[in] Bp

トリガーされたブレークポイントに対応する IDebugBreakpoint オブジェクトへのポインターを指定します。

戻り値

このメソッドは、DEBUG_STATUS_XXX 値を返します。これは、エンジンがこのイベントを処理した後にターゲットの実行を続行する方法を示します。 エンジンによるこの値の処理方法の詳細については、「監視イベントの」を参照してください。

備考

ブレークポイントにコマンドが関連付けられている場合、エンジンはこのメソッドを呼び出す前にそのコマンドを実行します。

このメソッドは、ブレークポイントに対応する IDebugBreakpoint オブジェクトがエンジンに存在し、ブレークポイントがプライベート ブレークポイントである場合にのみ、このメソッドを呼び出します。ブレークポイントを追加したクライアントに登録された IDebugEventCallbacks オブジェクト します。

エンジンは、DEBUG_EVENT_BREAKPOINT フラグが IDebugEventCallbacks::GetInterestMask によって返されるマスク設定されている場合にのみ、このメソッドを呼び出します。

ブレークポイントが削除されると (たとえば、RemoveBreakpointを使用して) IDebugBreakpoint オブジェクト エンジンによって削除されるため、ブレークポイント が返された後 Bp の値が無効になる可能性があります。 そのため、ブレークポイント が戻った 後、IDebugEventCallbacks の実装 Bp にアクセスすることはできません。

イベントの処理の詳細については、「監視イベントの」を参照してください。 ブレークポイントの管理については、「ブレークポイントの 」を参照してください。

必要条件

要件	価値
ターゲット プラットフォーム の	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)