IDebugEventContextCallbacks インターフェイス (dbgeng.h)
このインターフェイスには、各イベント コールバックの "context" パラメーターとして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 IDebugEventContextCallbacks::CreateThread コールバック メソッドは、ターゲットで create-threaddebugging イベントが発生したときにエンジンによって呼び出されます。 |
| IDebugEventContextCallbacks::Exception IDebugEventContextCallbacks::Exception コールバック メソッドは、ターゲットで例外デバッグ イベントが発生したときにエンジンによって呼び出されます。 |
| IDebugEventContextCallbacks::ExitProcess IDebugEventContextCallbacks::ExitProcess コールバック メソッドは、ターゲットで終了プロセス デバッグ イベントが発生したときにエンジンによって呼び出されます。 |
| IDebugEventContextCallbacks::ExitThread IDebugEventContextCallbacks::ExitThread コールバック メソッドは、ターゲットで終了スレッド デバッグ イベントが発生したときにエンジンによって呼び出されます。 |
| IDebugEventContextCallbacks::GetInterestMask クライアントに対してイベント コールバックが設定されると、エンジンは GetInterestMask を 1 回呼び出します。 |
| 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 を含む) |