Auf Englisch lesen

Freigeben über


KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion (wdm.h)

Vom Treiber implementierte Rückruffunktionen, die vom System ausgeführt werden, wenn sie eine Fehlerüberprüfung ausgibt.

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

Syntax

C++
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 Aufzählung 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 beim Registrieren dieses Rückrufs bereitgestellt hat. Weitere Informationen finden Sie in der Beschreibung des parameters CallbackRecord in KeRegisterBugCheckReasonCallback.

[in, out] ReasonSpecificData

Zeigen Sie auf einen Puffer, der eine Struktur des Typs enthält, die von der folgenden Tabelle bestimmt wird. Bestimmte Member dieser Struktur werden vom Betriebssystem ausgefüllt, bevor sie die Rückrufroutine aufruft, und andere Member müssen von der Rückrufroutine ausgefüllt werden. Weitere Informationen finden Sie unter Schreiben einer Fehlerüberprüfungsrückrufroutine.

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

Nichts

Bemerkungen

Informationen zum Implementieren dieser Rückrufroutine finden Sie unter Schreiben einer Fehlerüberprüfungsrückrufroutine.

Beispielcode zum Schreiben von Daten in die Absturzabbilddatei finden Sie unter DMF_CrashDump.

Anforderungen

Anforderung Wert
Zielplattform- Desktop
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL- Wird bei HIGH_LEVEL aufgerufen.

Siehe auch

KBUGCHECK_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Schreiben einer Fehlerüberprüfungsroutine.