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.
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
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.
Nichts
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.
Anforderung | Wert |
---|---|
Zielplattform- | Desktop |
Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
IRQL- | Wird bei HIGH_LEVEL aufgerufen. |
KBUGCHECK_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback