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


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

Метод обратного вызова 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 , отключен.

Комментарии

Этот метод вызывается обработчиком только в том случае, если флаг DEBUG_EVENT_CHANGE_ENGINE_STATE установлен в маске, возвращаемой методом IDebugEventCallbacks::GetInterestMask.

Дополнительные сведения об обработке событий см. в разделе События мониторинга.

Требования

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