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

2025-02-07

Функции обратного вызова, реализованные драйвером, которые система выполняет при возникновении ошибки.

Сведения о доступных типах обратного вызова см. в KBUGCHECK_CALLBACK_REASON.

Синтаксис

KBUGCHECK_REASON_CALLBACK_ROUTINE KbugcheckReasonCallbackRoutine;

void KbugcheckReasonCallbackRoutine(
  [in]      KBUGCHECK_CALLBACK_REASON Reason,
  [in]      _KBUGCHECK_REASON_CALLBACK_RECORD *Record,
  [in, out] PVOID ReasonSpecificData,
  [in]      ULONG ReasonSpecificDataLength
)
{...}

Параметры

[in] Reason

Перечисление типа KBUGCHECK_CALLBACK_REASON, указывающее причину вызова подпрограммы обратного вызова.

[in] Record

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

[in, out] ReasonSpecificData

Указатель на буфер, содержащий структуру типа, определяемую таблицей ниже. Некоторые члены этой структуры заполняются операционной системой перед вызовом подпрограммы обратного вызова, а другие члены должны быть заполнены подпрограммой обратного вызова. Дополнительные сведения см. в статье Написание подпрограммы обратного вызова проверки ошибок.

Ценность	Структура данных
KbCallbackSecondaryDumpData	KBUGCHECK_SECONDARY_DUMP_DATA
KbCallbackDumpIo	KBUGCHECK_DUMP_IO
KbCallbackAddPages	KBUGCHECK_ADD_PAGES
KbCallbackSecondaryMultiPartDumpData	KBUGCHECK_SECONDARY_DUMP_DATA_EX
KbCallbackRemovePages	KBUGCHECK_REMOVE_PAGES
KbCallbackTriageDumpData	KBUGCHECK_TRIAGE_DUMP_DATA

[in] ReasonSpecificDataLength

Задает размер в байтах буфера, на который указывает параметр ReasonSpecificData.

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

Никакой

Замечания

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

Пример кода, демонстрирующий запись данных в файл аварийного дампа, см. в DMF_CrashDump.

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Вызывается в HIGH_LEVEL.