KeBugCheck-Funktion (ntddk.h)
Die KeBugCheck Routine führt das System kontrolliert herunter, wenn der Aufrufer eine nicht behebbare Inkonsistenz erkennt, die das System beschädigt, wenn der Aufrufer weiterhin ausgeführt wird.
Syntax
void KeBugCheck(
[in] ULONG BugCheckCode
);
Parameter
[in] BugCheckCode
Gibt einen Wert an, der den Grund für die Fehlerüberprüfung angibt.
Rückgabewert
Nichts
Bemerkungen
Eine Fehlerüberprüfung ist ein vom System erkannter Fehler, der ein sofortiges, kontrolliertes Herunterfahren des Systems verursacht. Verschiedene Kernelmoduskomponenten führen eine Überprüfung der Laufzeitkonsistenz durch. Wenn eine solche Komponente eine nicht behebbare Inkonsistenz erkennt, wird eine Fehlerüberprüfung generiert.
Wenn möglich, sollten alle Kernelmoduskomponenten einen Fehler protokollieren und weiterhin ausgeführt werden, anstatt KeBugCheck-aufzurufen. Wenn beispielsweise ein Treiber die erforderlichen Ressourcen nicht zuordnen kann, sollte ein Fehler protokolliert werden, damit das System weiterhin ausgeführt wird. es darf keine Fehlerüberprüfung generieren.
Ein Treiber oder eine andere Kernelmoduskomponente sollte diese Routine nur in Fällen eines schwerwiegenden, nicht behebbaren Fehlers aufrufen, der das System selbst beschädigen könnte.
KeBugCheck kann in den frühen Phasen der Entwicklung eines Treibers oder während des Tests nützlich sein. Unter diesen Umständen sollte sich die BugCheckCode-, die an diese Routine übergeben werden, von diesen Codes unterscheiden, die bereits von Windows oder seinen Treibern verwendet werden. Eine Liste dieser Codes finden Sie unter Fehlerüberprüfungscodes.
Selbst bei der Treiberentwicklung ist diese Routine jedoch nur von begrenztem Dienstprogramm, da sie zu einem vollständigen System heruntergefahren wird. Eine effektivere Debuggingmethode besteht darin, einen Kerneldebugger an das System anzufügen und dann Routinen zu verwenden, die Nachrichten an den Debugger senden oder in den Debugger aufteilen. Weitere Informationen finden Sie unter Erste Schritte mit WinDbg (Kernelmodus).
Wenn eine Fehlerüberprüfung unvermeidbar ist, rufen die meisten Systemkomponenten KeBugCheckExauf, die mehr Informationen über die Ursache einer solchen Inkonsistenz als KeBugCheck.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | ntddk.h (include Ntddk.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Beliebige Ebene |