énumération KBUGCHECK_CALLBACK_REASON (wdm.h)

Article
02/07/2025

Le type d’énumération KBUGCHECK_CALLBACK_REASON spécifie les situations dans lesquelles un rappel de vérification des bogues s’exécute.

Syntaxe

typedef enum _KBUGCHECK_CALLBACK_REASON {
  KbCallbackInvalid,
  KbCallbackReserved1,
  KbCallbackSecondaryDumpData,
  KbCallbackDumpIo,
  KbCallbackAddPages,
  KbCallbackSecondaryMultiPartDumpData,
  KbCallbackRemovePages,
  KbCallbackTriageDumpData,
  KbCallbackReserved2,
  KbCallbackReserved3
} KBUGCHECK_CALLBACK_REASON;

Constantes


`KbCallbackInvalid` Réservé à l’utilisation du système. N’utilisez pas.
`KbCallbackReserved1` Réservé à l’utilisation du système. N’utilisez pas.
`KbCallbackSecondaryDumpData` La fonction de rappel fournit des données à ajouter à la zone de données secondaire du fichier de vidage sur incident lorsque le système émet une vérification des bogues. Pour plus d’informations sur ce type de rappel, consultez Implémentation d’une routine de rappel KbCallbackSecondaryDumpData.
`KbCallbackDumpIo` Spécifie que le système doit appeler la fonction de rappel chaque fois qu’il écrit des données dans un fichier de vidage sur incident. Les pilotes pour les appareils qui surveillent l’état du système peuvent utiliser ce type de rappel. Pour plus d’informations sur ce type de rappel, consultez Implémentation d’une routine de rappel KbCallbackDumpIo.
`KbCallbackAddPages` La fonction de rappel ajoute une ou plusieurs pages de données spécifiques au pilote à la section principale du fichier de vidage sur incident lorsque le système d’exploitation émet une vérification des bogues. Pour plus d’informations sur ce type de rappel, consultez Implémentation d’une routine de rappel KbCallbackAddPages.
`KbCallbackSecondaryMultiPartDumpData` Spécifie que le rappel est exécuté pour obtenir la quantité de données que le pilote souhaite stocker dans le fichier de vidage. Cette valeur d’énumération est prise en charge dans Windows Server 2008 et versions ultérieures de Windows.
`KbCallbackRemovePages` La fonction de rappel supprime une ou plusieurs pages de données fournies par le pilote du fichier de vidage sur incident. Pour plus d’informations, consultez KBUGCHECK_REMOVE_PAGES.
`KbCallbackTriageDumpData` Spécifie que le rappel est exécuté pour ajouter des plages de mémoire virtuelles que le pilote souhaite conserver dans le fichier minidump sculpté. Cette valeur d’énumération est prise en charge à partir de Windows 10, version 1809 et Windows Server 2019. Pour plus d’informations sur ce type de rappel, consultez Implémentation d’une routine de rappel KbCallbackTriageDumpData.
`KbCallbackReserved2` Réservé à l’utilisation du système. N’utilisez pas.
`KbCallbackReserved3` Réservé à l’utilisation du système. N’utilisez pas.

Remarques

Un pilote utilise cette énumération pour spécifier le type de routine de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE à inscrire lorsqu’elle appelle la fonction KeRegisterBugCheckReasonCallback.

Pour plus d’informations sur l’utilisation de cette énumération, consultez Écriture d’une routine de rappel de vérification des bogues.

Exigences

Exigence	Valeur
client minimum pris en charge	Pris en charge sur Windows XP avec Service Pack 1 (SP1), Windows Server 2003 et versions ultérieures du système d’exploitation Windows.
d’en-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)

Voir aussi

écrire une routine de rappel de vérification des bogues

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

Partager via