Fonction KeRegisterBugCheckReasonCallback (wdm.h)

Article
02/27/2024

La fonction KeRegisterBugCheckReasonCallback enregistre une routine de rappel qui s’exécute lorsque le système d’exploitation émet un bogue case activée.

Syntaxe

BOOLEAN KeRegisterBugCheckReasonCallback(
  [out] PKBUGCHECK_REASON_CALLBACK_RECORD  CallbackRecord,
  [in]  PKBUGCHECK_REASON_CALLBACK_ROUTINE CallbackRoutine,
  [in]  KBUGCHECK_CALLBACK_REASON          Reason,
  [in]  PUCHAR                             Component
);

Paramètres

[out] CallbackRecord

Pointeur vers une structure KBUGCHECK_REASON_CALLBACK_RECORD qui a été initialisée par un appel à la routine KeInitializeCallbackRecord décrite dans les macros du noyau Windows.

[in] CallbackRoutine

Pointeur vers une routine de rappel de type KBUGCHECK_REASON_CALLBACK_ROUTINE à inscrire. Pour plus d’informations sur l’implémentation de cette routine de rappel, consultez Écriture d’une routine de rappel de vérification des bogues.

[in] Reason

Énumération de type KBUGCHECK_CALLBACK_REASON qui spécifie le type de routine de rappel vers lequel callbackRoutine pointe.

[in] Component

Pointeur vers une chaîne ANSI terminée par null qui identifie l’appelant. Par exemple, vous pouvez sélectionner une chaîne qui décrit le pilote de périphérique ou qui contient le nom de l’appareil. Vous pouvez utiliser l’extension de débogueur !bugdump pour afficher les données de vidage sur incident associées à cette chaîne.

Valeur retournée

KeRegisterBugCheckReasonCallback retourne TRUE si la routine de rappel est correctement inscrite ; sinon, il retourne FALSE.

Remarques

Les pilotes peuvent utiliser KeRegisterBugCheckReasonCallback pour inscrire des routines qui s’exécutent pendant une case activée de bogue système.

Pour obtenir une description de chaque type de rappel, consultez KBUGCHECK_CALLBACK_REASON.

Les pilotes peuvent utiliser la routine KeDeregisterBugCheckReasonCallback pour supprimer le bogue case activée inscription de rappel. Tout pilote qui peut être déchargé doit supprimer les inscriptions de tous ses rappels dans sa routine de déchargement .

Pour plus d’informations sur l’implémentation de ces routines de rappel, consultez Écriture d’une routine de rappel de vérification des bogues.

Pour afficher des données de vidage secondaires, vous pouvez utiliser la méthode IDebugDataSpaces3 ::ReadTagged** dans une extension de débogueur. Une autre option consiste à déboguer le bogue case activée routine de rappel elle-même. Pour plus d’informations sur les débogueurs et les extensions de débogueur, consultez Débogage Windows.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows XP Service Pack 1 (SP1), Windows Server 2003 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	N’importe quel niveau