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

Статья
02/29/2024

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

Сведения о доступных типах обратного вызова см. в 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 .

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

None

Remarks

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

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

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
IRQL	Вызывается на HIGH_LEVEL.