KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion (wdm.h)

  • Artikel

Vom Treiber implementierte Rückruffunktionen, die das System ausführt, wenn es eine Fehlerprüfung ausgibt.

Informationen zu verfügbaren Rückruftypen finden Sie unter KBUGCHECK_CALLBACK_REASON .

Syntax

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
)
{...}

Parameter

[in] Reason

Eine Enumeration vom Typ KBUGCHECK_CALLBACK_REASON , die den Grund für den Aufruf der Rückrufroutine angibt.

[in] Record

Ein Zeiger auf die KBUGCHECK_REASON_CALLBACK_RECORD Struktur, die der Treiber bei der Registrierung dieses Rückrufs bereitgestellt hat. Weitere Informationen finden Sie in der Beschreibung des CallbackRecord-Parameters in KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Zeiger auf einen Puffer, der eine Struktur vom Typ enthält, die durch die folgende Tabelle bestimmt wird. Bestimmte Member dieser Struktur werden vom Betriebssystem ausgefüllt, bevor die Rückrufroutine aufgerufen wird, und andere Member müssen von der Rückrufroutine ausgefüllt werden. Weitere Informationen finden Sie unter Schreiben einer Rückrufroutine für die Fehlerüberprüfung.

Wert Datenstruktur
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

Gibt die Größe des Puffers in Bytes an, auf den der ReasonSpecificData-Parameter verweist.

Rückgabewert

Keine

Bemerkungen

Informationen zum Implementieren dieser Rückrufroutine finden Sie unter Schreiben einer Rückrufroutine für die Fehlerüberprüfung.

Beispielcode, der zeigt, wie Daten in die Absturzabbilddatei geschrieben werden, finden Sie unter DMF_CrashDump.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
IRQL Wird bei HIGH_LEVEL aufgerufen.

Weitere Informationen

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Schreiben einer Rückrufroutine für die Fehlerüberprüfung.