перечисление KBUGCHECK_CALLBACK_REASON (wdm.h)

Статья
02/07/2025

Тип перечисления KBUGCHECK_CALLBACK_REASON указывает ситуации, в которых выполняется обратный вызов проверки ошибок.

Синтаксис

typedef enum _KBUGCHECK_CALLBACK_REASON {
  KbCallbackInvalid,
  KbCallbackReserved1,
  KbCallbackSecondaryDumpData,
  KbCallbackDumpIo,
  KbCallbackAddPages,
  KbCallbackSecondaryMultiPartDumpData,
  KbCallbackRemovePages,
  KbCallbackTriageDumpData,
  KbCallbackReserved2,
  KbCallbackReserved3
} KBUGCHECK_CALLBACK_REASON;

Константы


`KbCallbackInvalid` Зарезервировано для использования системы. Не используйте.
`KbCallbackReserved1` Зарезервировано для использования системы. Не используйте.
`KbCallbackSecondaryDumpData` Функция обратного вызова предоставляет данные для добавления к дополнительной области данных файла аварийного дампа, когда система выдает проверку ошибок. Дополнительные сведения об этом типе обратного вызова см. в реализацииподпрограммы обратного вызова KbCallbackSecondaryDumpData.
`KbCallbackDumpIo` Указывает, что система должна вызывать функцию обратного вызова при каждом записи данных в файл аварийного дампа. Драйверы для устройств, отслеживающих состояние системы, могут использовать этот тип обратного вызова. Дополнительные сведения об этом типе обратного вызова см. в разделе Реализации подпрограммы обратного вызова KbCallbackDumpIo.
`KbCallbackAddPages` Функция обратного вызова добавляет одну или несколько страниц данных для конкретного драйвера в основной раздел файла аварийного дампа, когда операционная система выдает проверку ошибок. Дополнительные сведения об этом типе обратного вызова см. в реализацииподпрограммы обратного вызова KbCallbackAddPages.
`KbCallbackSecondaryMultiPartDumpData` Указывает, что обратный вызов выполняется для получения объема данных, которые драйвер хочет сохранить в файле дампа. Это значение перечисления поддерживается в Windows Server 2008 и более поздних версиях Windows.
`KbCallbackRemovePages` Функция обратного вызова удаляет одну или несколько страниц предоставленных драйвером данных из файла аварийного дампа. Дополнительные сведения см. в KBUGCHECK_REMOVE_PAGES.
`KbCallbackTriageDumpData` Указывает, что обратный вызов выполняется для добавления диапазонов виртуальной памяти, которые драйвер хочет сохранить в резном мини-файле. Это значение перечисления поддерживается начиная с Windows 10 версии 1809 и Windows Server 2019. Дополнительные сведения об этом типе обратного вызова см. в реализацииподпрограммы обратного вызова KbCallbackTriageDumpData.
`KbCallbackReserved2` Зарезервировано для использования системы. Не используйте.
`KbCallbackReserved3` Зарезервировано для использования системы. Не используйте.

Замечания

Драйвер использует это перечисление, чтобы указать тип подпрограммы обратного вызова KBUGCHECK_REASON_CALLBACK_ROUTINE для регистрации при вызове функции KeRegisterBugCheckReasonCallback.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается в Windows XP с пакетом обновления 1 (SP1), Windows Server 2003 и более поздними версиями операционной системы Windows.
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

См. также

написание подпрограммы обратного вызова проверки ошибок

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

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