IDebugEventCallbacks：：ChangeEngineState 方法 (dbgeng.h)

發行項
02/23/2024

當引擎的狀態變更時， 會呼叫 ChangeEngineState 回呼方法。

語法

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

參數

[in] Flags

指定位集，指出引擎狀態中發生的變更類型。可能會設定下列位旗標：

值	Description
DEBUG_CES_CURRENT_THREAD	目前的線程已變更，這表示目前的目標和目前的進程可能也會變更。
DEBUG_CES_EFFECTIVE_PROCESSOR	有效的處理器已變更。
DEBUG_CES_BREAKPOINTS	一或多個斷點已變更。
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 的值是目前的引擎線程標識碼，或者如果沒有目前的線程--DEBUG_ANY_ID。如需詳細資訊，請參閱線程和進程。

DEBUG_CES_EFFECTIVE_PROCESSOR

Argument 的值是有效處理器的類型。

DEBUG_CES_BREAKPOINTS

Argument 的值是已變更之斷點的斷點標識碼，或者，如果有多個斷點已變更，則為 --DEBUG_ANY_ID。如需詳細資訊，請參閱中斷點。

DEBUG_CES_CODE_LEVEL

Argument 的值是程式代碼解譯層級。

DEBUG_CES_EXECUTION_STATUS

Argument 的值是執行狀態 (，如DEBUG_STATUS_XXX主題中所述，) 可能與位旗標DEBUG_STATUS_INSIDE_WAIT結合。當 WaitForEvent 呼叫擱置時，就會設定DEBUG_STATUS_INSIDE_WAIT。如需詳細資訊，請參閱偵錯會話和執行模型。

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 的值是零。

DEBUG_CES_SYSTEMS

Argument 的值是已新增的目標目標目標標識碼，如果目標已移除，則為 --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旗標時，引擎才會呼叫此方法。

如需處理事件的詳細資訊，請參閱監視事件。

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)

共用方式為