KBUGCHECK_REASON_CALLBACK_ROUTINE fonction de rappel (wdm.h)
Fonctions de rappel implémentées par le pilote que le système exécute lorsqu’il émet un bogue case activée.
Consultez KBUGCHECK_CALLBACK_REASON pour plus d’informations sur les types de rappel disponibles.
Syntaxe
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
)
{...}
Paramètres
[in] Reason
Énumération de type KBUGCHECK_CALLBACK_REASON qui spécifie la raison de l’appel à la routine de rappel.
[in] Record
Pointeur vers la structure KBUGCHECK_REASON_CALLBACK_RECORD fournie par le pilote lors de l’inscription de ce rappel. Pour plus d’informations, consultez la description du paramètre CallbackRecord dans KeRegisterBugCheckReasonCallback.
[in, out] ReasonSpecificData
Pointeur vers une mémoire tampon qui contient une structure de type déterminé par le tableau ci-dessous. Certains membres de cette structure sont renseignés par le système d’exploitation avant d’appeler la routine de rappel, et d’autres membres doivent être renseignés par la routine de rappel. Pour plus d’informations, consultez Rédaction d’une routine de rappel de vérification des bogues.
Valeur | Structure de données |
---|---|
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
Spécifie la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre ReasonSpecificData .
Valeur de retour
None
Remarques
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.
Pour obtenir un exemple de code qui montre comment écrire des données dans le fichier de vidage sur incident, consultez DMF_CrashDump.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h) |
IRQL | Appelé à HIGH_LEVEL. |
Voir aussi
KBUGCHECK_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback
KeDeregisterBugCheckReasonCallback
Écriture d’une routine de rappel de vérification des bogues.