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

[アーティクル]
02/06/2025

ChangeEngineState コールバックメソッドは、その状態が変更されたときにエンジンによって呼び出されます。

構文

HRESULT ChangeEngineState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

パラメーター

[in] Flags

エンジンの状態で発生した変更の種類を示すビットセットを指定します。次のビットフラグが設定される場合があります。

価値	形容
DEBUG_CES_CURRENT_THREAD	現在のスレッドが変更されました。これは、現在のターゲットと現在のプロセスも変更された可能性があることを意味します。
DEBUG_CES_EFFECTIVE_PROCESSOR	有効なプロセッサが変更されました。
DEBUG_CES_BREAKPOINTS	1 つ以上のブレークポイントが変更。
DEBUG_CES_CODE_LEVEL	コード解釈レベルが変更されました。
DEBUG_CES_EXECUTION_STATUS	実行状態が変更されました。
DEBUG_CES_ENGINE_OPTIONS	エンジンのオプションが変更されました。
DEBUG_CES_LOG_FILE	ログファイルが開かれているか閉じられました。
DEBUG_CES_RADIX	既定の基数が変更されました。
DEBUG_CES_EVENT_FILTERS	イベントフィルターが変更されました。
DEBUG_CES_PROCESS_OPTIONS	現在のプロセスのプロセスオプションが変更されました。
DEBUG_CES_EXTENSIONS	拡張 DLL が読み込まれたかアンロードされました。 (詳細については、「デバッガー拡張機能 DLL読み込む」を参照してください)。
DEBUG_CES_SYSTEMS	ターゲットが追加または削除されました。
DEBUG_CES_ASSEMBLY_OPTIONS	アセンブルオプションが変更されました。
DEBUG_CES_EXPRESSION_SYNTAX	既定の式の構文が変更されました。
DEBUG_CES_TEXT_REPLACEMENTS	テキストの置換が変更されました。

[in] Argument

エンジンの状態の変更に関する追加情報を提供します。 Flags パラメーターに複数のビットフラグが設定されている場合、Argument パラメーターは使用されません。それ以外の場合、引数の値解釈は、Flagsの値によって異なります。

DEBUG_CES_CURRENT_THREAD

引数の値は、現在のエンジンスレッド ID です。現在のスレッドがない場合は--DEBUG_ANY_ID。詳細については、「スレッドとプロセスの」を参照してください。

DEBUG_CES_EFFECTIVE_PROCESSOR

引数の値は、有効なプロセッサの型です。

DEBUG_CES_BREAKPOINTS

引数の値は、変更されたブレークポイントのブレークポイント ID です。または、複数のブレークポイントが変更された場合は DEBUG_ANY_ID。詳細については、「ブレークポイントをする」を参照してください。

DEBUG_CES_CODE_LEVEL

引数値は、コード解釈レベルです。

DEBUG_CES_EXECUTION_STATUS

引数の値は、実行状態 (DEBUG_STATUS_XXX トピックで説明) とビットフラグのDEBUG_STATUS_INSIDE_WAITが組み合わされている可能性があります。 DEBUG_STATUS_INSIDE_WAITは、WaitForEvent 呼び出しが保留中のときに設定されます。詳細については、「デバッグセッションと実行モデルの」を参照してください。

DEBUG_CES_ENGINE_OPTIONS

引数の値エンジンオプションです。

DEBUG_CES_LOG_FILE

引数の値は、ログファイルが開かれた場合は TRUE され、ログファイルが閉じられた場合は FALSE がされます。

DEBUG_CES_RADIX

引数の値は、既定の基数です。

DEBUG_CES_EVENT_FILTERS

引数の値は、変更されたイベントフィルターのインデックスです。複数のイベントフィルターが変更された場合は--DEBUG_ANY_ID。

DEBUG_CES_PROCESS_OPTIONS

引数の値は、現在のプロセスのプロセスオプションです。

DEBUG_CES_EXTENSIONS

引数の値は 0 です。

DEBUG_CES_SYSTEMS

引数の値は、追加されたターゲットのターゲット ID です。ターゲットが削除された場合は--DEBUG_ANY_ID。

DEBUG_CES_ASSEMBLE_OPTIONS

引数の値は、アセンブルオプションです。

DEBUG_CES_EXPRESSION_SYNTAX

引数の値既定の式の構文です。

DEBUG_CES_TEXT_REPLACEMENTS

引数の値 DEBUG_ANY_ID。

戻り値

戻り値は、リモートプロシージャ呼び出しエラーを示す場合を除き、エンジンによって無視されます。この場合、この IDebugEventCallbacks オブジェクトが登録されているクライアントは無効になります。

備考

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

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

必要条件

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

次の方法で共有