KeBugCheck, fonction (ntddk.h)
La routine KeBugCheck entraîne l’arrêt du système de manière contrôlée lorsque l’appelant découvre une incohérence irrécupérable qui endommagerait le système si l’appelant continuait à s’exécuter.
Syntaxe
void KeBugCheck(
[in] ULONG BugCheckCode
);
Paramètres
[in] BugCheckCode
Spécifie une valeur qui indique la raison de la vérification des bogues.
Valeur de retour
Aucun
Remarques
Une vérification des bogues est une erreur détectée par le système qui provoque un arrêt immédiat et contrôlé du système. Différents composants en mode noyau effectuent une vérification de cohérence au moment de l’exécution. Lorsqu’un tel composant découvre une incohérence irrécupérable, il provoque la génération d’une vérification des bogues.
Dans la mesure du possible, tous les composants en mode noyau doivent consigner une erreur et continuer à s’exécuter, plutôt que d’appeler KeBugCheck. Par exemple, si un pilote ne parvient pas à allouer les ressources requises, il doit consigner une erreur afin que le système continue à s’exécuter ; elle ne doit pas générer de vérification de bogue.
Un pilote ou un autre composant en mode noyau doit appeler cette routine uniquement en cas d’erreur irrécupérable irrécupérable qui pourrait endommager le système lui-même.
KeBugCheck peut être utile dans les premières étapes du développement d’un pilote, ou pendant qu’il subit des tests. Dans ces circonstances, la BugCheckCode passée à cette routine doit être distincte de ces codes déjà utilisés par Windows ou ses pilotes. Pour obtenir la liste de ces codes, consultez codes de vérification des bogues.
Toutefois, même au cours du développement du pilote, cette routine n’est qu’un utilitaire limité, car elle entraîne un arrêt complet du système. Une méthode de débogage plus efficace consiste à attacher un débogueur de noyau au système, puis à utiliser des routines qui envoient des messages au débogueur ou se décomposent dans le débogueur. Pour plus d’informations, consultez Prise en main de WinDbg (mode noyau).
Lorsqu’une vérification des bogues est inévitable, la plupart des composants système appellent KeBugCheckEx, qui fournit plus d’informations sur la cause d’une telle incohérence que KeBugCheck.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | ntddk.h (include Ntddk.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | N’importe quel niveau |