Метод 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	Одна или несколько точек останова изменились.
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

Предоставляет дополнительные сведения об изменении состояния подсистемы. Если в параметре флагов задано несколько битовых флагов, параметр аргумента не используется. В противном случае интерпретация значения аргумента зависит от значения флагов :

DEBUG_CES_CURRENT_THREAD

Значение аргумента является текущим идентификатором потока подсистемы или,если текущий поток-DEBUG_ANY_ID отсутствует. Дополнительные сведения см. в потоках и процессах.

DEBUG_CES_EFFECTIVE_PROCESSOR

Значение аргумента — это тип эффективного процессора.

DEBUG_CES_BREAKPOINTS

Значение аргумента — это идентификатор точки останова точки останова, которая была изменена или если было изменено несколько точек останова, 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

Значение аргумента равно нулю.

DEBUG_CES_SYSTEMS

Значение аргумента — это идентификатор целевого объекта, который был добавлен или-если целевой объект был удален--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 (include Dbgeng.h)

Поделиться через