Метод IDebugEventCallbacks::ChangeEngineState (dbgeng.h)

Статья
08/07/2023

Метод обратного вызова 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

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

DEBUG_CES_CURRENT_THREAD

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

DEBUG_CES_EFFECTIVE_PROCESSOR

Значение Argument является типом действующего процессора.

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

Значение Argument — это параметры процесса для текущего процесса.

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 , отключен.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	dbgeng.h (включая Dbgeng.h)

Share via