デバッグ エンジン (DE) では通常、次のいずれかのイベントを最後の起動イベントとして送信します。
エントリ ポイント イベント (新しく起動したプログラムにアタッチする場合)
読み込み完了イベント (既に実行されているプログラムにアタッチする場合)
これらのイベントはどちらも停止イベントです。これは、DE がユーザーからの応答を IDE で待機するという意味です。 詳細については、「操作モード」を参照してください。
停止イベント
停止イベントがデバッグ セッションに送信されると、次のようになります。
現在の命令ポインターを含むプログラムとスレッドは、イベント インターフェイスから取得できます。
IDE によって、現在のソース コード ファイルと位置が決定され、エディターで強調表示されます。
デバッグ セッションでは通常、プログラムの Continue メソッドを呼び出して、この最初の停止イベントに応答します。
プログラムはその後、ブレークポイントにヒットするなどの停止条件が発生するまで実行されます。 この場合、DE はブレークポイント イベントをデバッグ セッションに送信します。 ブレークポイント イベントは停止イベントであり、DE はもう一度ユーザー応答を待機します。
ユーザーが関数のステップ イン、ステップ オーバー、またはステップ アウトを選択した場合、IDE は、プログラムの
Stepメソッドを呼び出すようデバッグ セッションに求めます。 IDE はその後、ステップの単位 (命令、ステートメント、または行) とステップの種類 (関数のステップ イン、ステップ オーバー、またはステップ アウト) を渡します。 ステップが完了すると、DE はステップ完了イベントをデバッグ セッションに送信しますが、これが停止イベントです。または
ユーザーが現在の命令ポインターから実行を継続することを選択した場合、IDE は、プログラムの Execute メソッドを呼び出すようデバッグ セッションに求めます。 プログラムは、次の停止条件に遭遇するまで実行を再開します。
または
デバッグ セッションで特定の停止イベントを無視することにした場合、デバッグ セッションはプログラムの Continue メソッドを呼び出します。 停止条件が発生したときにプログラムで関数のステップ イン、ステップ オーバー、またはステップ アウト中だった場合、プログラムはステップを継続します。
停止条件が発生すると、DE ではプログラムによって、IDebugLoadCompleteEvent2 や IDebugEntryPointEvent2 などの停止イベントを、IDebugEventCallback2 インターフェイスを使用してセッション デバッグ マネージャー (SDM) に送信します。 DE は、現在の命令ポインターを含むプログラムとスレッドを表す IDebugProgram2 および IDebugThread2 インターフェイスを渡します。 SDM は、IDebugThread2::EnumFrameInfo を呼び出して一番上のスタック フレームを取得し、IDebugStackFrame2::GetDocumentContext を呼び出して、現在の命令ポインターに関連付けられているドキュメント コンテキストを取得します。 このドキュメント コンテキストは通常、ソース コード ファイルの名前、行、および列番号です。 IDE ではこれらを使用して、現在の命令ポインターを含むソース コードを強調表示します。
SDM では通常、IDebugProgram2::Continue を呼び出して、この最初の停止イベントに応答します。 プログラムはその後、ブレークポイントにヒットするなどの停止条件が発生するまで実行されます。この場合、DE は IDebugBreakpointEvent2 インターフェイスを SDM に送信します。 ブレークポイント イベントは停止イベントであり、DE はもう一度ユーザー応答を待機します。
関数のステップ イン、ステップ オーバー、またはステップ アウトをユーザーが選択した場合、IDE は、IDebugProgram2::Step を呼び出すよう SDM に求めます。 IDE はその後、STEPUNIT (命令、ステートメント、または行) と STEPKIND (関数のステップ イン、ステップ オーバー、またはステップ アウト) を渡します。 ステップが完了すると、DE は IDebugStepCompleteEvent2 インターフェイスを SDM に送信しますが、これが停止イベントです。
現在の命令ポインターから実行を継続することをユーザーが選択した場合、IDE は、IDebugProgram2::Execute を呼び出すよう SDM に求めます。 プログラムは、次の停止条件に遭遇するまで実行を再開します。
デバッグ パッケージで特定の停止イベントを無視することにした場合、デバッグ パッケージは SDM を呼び出し、SDM は IDebugProgram2::Continue を呼び出します。 停止条件が発生したときにプログラムで関数のステップ イン、ステップ オーバー、またはステップ アウト中だった場合、プログラムはステップを継続します。 これは、プログラムはステッピング状態を維持しているので継続方法を知っていることを暗示します。
SDM による
Step、Execute、および Continue の呼び出しは非同期です。つまり、SDM は呼び出しからすぐに制御が戻ることを期待しています。Step、Execute、または Continue から制御が戻る前に DE が同じスレッドで停止イベントを SDM に送信した場合、SDM は応答を停止します。