KBUGCHECK_REASON_CALLBACK_ROUTINE fonction de rappel (wdm.h)

  • Article

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_ADD_PAGES

KBUGCHECK_CALLBACK_REASON

KBUGCHECK_REASON_CALLBACK_RECORD

KeRegisterBugCheckReasonCallback

KeDeregisterBugCheckReasonCallback

Écriture d’une routine de rappel de vérification des bogues.