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

[アーティクル]
02/23/2024

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 パラメーターは使用されません。それ以外の場合、 Argument の値の解釈は Flags の値によって異なります。

DEBUG_CES_CURRENT_THREAD

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

DEBUG_CES_EFFECTIVE_PROCESSOR

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

DEBUG_CES_BREAKPOINTS

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

DEBUG_CES_CODE_LEVEL

Argument の値は、コード解釈レベルです。

DEBUG_CES_EXECUTION_STATUS

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

DEBUG_CES_ENGINE_OPTIONS

Argument の値はエンジンオプションです。

DEBUG_CES_LOG_FILE

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

DEBUG_CES_RADIX

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

DEBUG_CES_EVENT_FILTERS

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

DEBUG_CES_PROCESS_OPTIONS

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

DEBUG_CES_EXTENSIONS

Argument の値は 0 です。

DEBUG_CES_SYSTEMS

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

DEBUG_CES_ASSEMBLE_OPTIONS

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

DEBUG_CES_EXPRESSION_SYNTAX

Argument の値は、既定の式構文です。

DEBUG_CES_TEXT_REPLACEMENTS

Argument の値はDEBUG_ANY_ID。

戻り値

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

注釈

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

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

要件

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)