функция обратного вызова PDEBUG_EXTENSION_NOTIFY (dbgeng.h)

Статья
06.02.2025

Подсистема вызывает функцию обратного вызова DebugExtensionNotify, чтобы сообщить библиотеке DLL расширения при изменении активного или доступного состояния сеанса.

C++

 CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;

Синтаксис

C++

PDEBUG_EXTENSION_NOTIFY PdebugExtensionNotify;

void PdebugExtensionNotify(
  [in] ULONG Notify,
  [in] ULONG64 Argument
)
{...}

Параметры

[in] Notify

Может быть любым из следующих значений:

Ценность	Описание
DEBUG_NOTIFY_SESSION_ACTIVE	Сеанс отладки активен. Сеанс может не обязательно быть приостановлен.
DEBUG_NOTIFY_SESSION_INACTIVE	Сеанс отладки не активен.
DEBUG_NOTIFY_SESSION_ACCESSIBLE	Сеанс отладки приостановлен и теперь доступен.
DEBUG_NOTIFY_SESSION_INACCESSIBLE	Сеанс отладки запущен и теперь недоступен.

[in] Argument

Установите значение нулю. (Зарезервировано для дальнейшего использования.)

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

Никакой

Замечания

Эта функция является необязательной. Библиотека DLL расширения DbgEng должна экспортировать только DebugExtensionNotify, если он хочет получать уведомления при изменении состояния сеанса. Подсистема ищет эту функцию по имени в библиотеке DLL расширения.

Эта функция позволяет библиотеке DLL расширения кэшировать сведения о сеансе без необходимости регистрировать явные обратные вызовы. Он вызывается в начале и конце сеанса, а при каждом запуске или остановке выполнения целевого объекта.

После инициализации библиотеки DLL расширения подсистема будет использовать эту функцию для уведомления библиотеки DLL о запуске сеанса. Если текущий сеанс приостановлен, подсистема вызовет эту функцию во второй раз, чтобы уведомить библиотеку DLL о доступности сеанса.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	dbgeng.h

См. также

DebugExtensionInitialize

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