KBUGCHECK_REASON_CALLBACK_ROUTINE - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// wdm.h

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
)
{...}
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (nc-wdm-kbugcheck_reason_callback_routine)

Description

Driver-implemented callback functions that the system executes when it issues a bug check.

See KBUGCHECK_CALLBACK_REASON for information on available callback types.

Parameters

Reason [in]

An enumeration of type KBUGCHECK_CALLBACK_REASON that specifies the reason for the call to the callback routine.

Record [in]

A pointer to the KBUGCHECK_REASON_CALLBACK_RECORD structure that the driver supplied when it registered this callback. For more information, see the description of the CallbackRecord parameter in KeRegisterBugCheckReasonCallback.

ReasonSpecificData [in, out]

Pointer to a buffer that contains a structure of type determined by the table below. Certain members of this structure are filled in by the operating system before it calls the callback routine, and other members must be filled in by the callback routine. For more information, see Writing a Bug Check Callback Routine.

Value Data structure
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

ReasonSpecificDataLength [in]

Specifies the size, in bytes, of the buffer that the ReasonSpecificData parameter points to.

Remarks

For information about how to implement this callback routine, see Writing a Bug Check Callback Routine.

For sample code that shows how to write data to the crash dump file, see DMF_CrashDump.

See also

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Writing a Bug Check Callback Routine.