Метод IDebugEventCallbacksWide::ChangeDebuggeeState (dbgeng.h)

Метод обратного вызова ChangeDebuggeeState вызывается подсистемой при внесении или обнаружении изменений в целевом объекте.

Синтаксис

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

Параметры

[in] Flags

Указывает тип изменений, внесенных в целевой объект. Флаги могут принимать одно из следующих значений:

Значение	Описание
DEBUG_CDS_ALL	Произошло общее изменение целевого объекта. Например, целевой объект выполняется или подсистема только что подключена к целевому объекту.
DEBUG_CDS_REGISTERS	Регистр процессора для целевого объекта изменился.
DEBUG_CDS_DATA	Пространство данных целевого объекта изменилось.

[in] Argument

Предоставляет дополнительные сведения об изменении целевого объекта. Интерпретация значения Argument зависит от значения Flags:

DEBUG_CDS_ALL

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

DEBUG_CDS_REGISTERS

Если один регистр изменился, значение Argument является индексом этого регистра. В противном случае значение Аргумента равно DEBUG_ANY_ID.

DEBUG_CDS_DATA

Значение Argument указывает, какое пространство данных было изменено. В следующей таблице содержатся возможные значения Argument.

Значение	Описание
DEBUG_DATA_SPACE_VIRTUAL	Виртуальная память целевого объекта изменилась.
DEBUG_DATA_SPACE_PHYSICAL	Физическая память целевого объекта изменилась.
DEBUG_DATA_SPACE_CONTROL	Память элемента управления целевого объекта изменилась.
DEBUG_DATA_SPACE_IO	Порты ввода-вывода целевого объекта получили входные или выходные данные.
DEBUG_DATA_SPACE_MSR	Регистры Model-Specific целевого объекта (MSR) изменились.
DEBUG_DATA_SPACE_BUS_DATA	Память шины целевого объекта изменилась.

 

Возвращаемое значение

Возвращаемое значение игнорируется подсистемой, если оно не указывает на ошибку удаленного вызова процедуры; В этом случае клиент, с помощью которого зарегистрирован этот объект IDebugEventCallbacksWide , отключен.

Комментарии

Подсистема вызывает ChangeDebuggeeState , только если флаг DEBUG_EVENT_CHANGE_DEBUGGEE_STATE установлен в маске, возвращенной IDebugEventCallbacksWide::GetInterestMask.

Дополнительные сведения об обработке событий см. в разделе События мониторинга. Сведения об управлении памятью целевого объекта, включая регистры и пространства данных, см. в разделе Доступ к памяти. Сведения о виртуальной и физической памяти целевого объекта см. в разделе Виртуальная и физическая память. Сведения о памяти управления целевого объекта, портах ввода-вывода, MSR и памяти шины см. в разделе Другие пространства данных.

Требования

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