функция обратного вызова PDEBUG_EXTENSION_NOTIFY (dbgeng.h)
Подсистема вызывает функцию обратного вызова DebugExtensionNotify , чтобы сообщить библиотеке DLL расширения при изменении сеанса своего активного или доступного состояния.
CALLBACK* PDEBUG_EXTENSION_NOTIFY DebugExtensionNotify;
Синтаксис
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
Задайте нулевое значение. (Зарезервировано для использования в будущем.)
Возвращаемое значение
None
Remarks
Эта функция является необязательной. Библиотека DLL расширения DbgEng должна экспортировать DebugExtensionNotify только в том случае, если она хочет получать уведомления об изменении состояния сеанса. Подсистема ищет эту функцию по имени в библиотеке DLL расширения.
Эта функция позволяет библиотеке DLL расширения кэшировать сведения о сеансе без регистрации явных обратных вызовов. Он вызывается в начале и конце сеанса и при каждом запуске или остановке выполнения целевого объекта.
После инициализации библиотеки DLL расширения подсистема будет использовать эту функцию для уведомления библиотеки DLL о запуске сеанса. Если текущий сеанс приостановлен, подсистема вызовет эту функцию во второй раз, чтобы уведомить библиотеку DLL о доступности сеанса.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | dbgeng.h |