KBUGCHECK_REASON_CALLBACK_ROUTINE Rückruffunktion (wdm.h)
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_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback