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 une vérification de bogue.
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ée 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 Écriture d’une routine de rappel de vérification des bogues.
| Valeur | Structure des 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
Aucun
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 montrant comment écrire des données dans le fichier de vidage sur incident, consultez DMF_CrashDump.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| IRQL | Appelé à HIGH_LEVEL. |
Voir aussi
KBUGCHECK_REASON_CALLBACK_RECORD
KeRegisterBugCheckReasonCallback