KBUGCHECK_TRIAGE_DUMP_DATA structure (wdm.h)

Article
08/08/2023

La structure _KBUGCHECK_TRIAGE_DUMP_DATA décrit les données de vidage utilisées conjointement avec la routine de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE .

Syntaxe

typedef struct _KBUGCHECK_TRIAGE_DUMP_DATA {
  PKTRIAGE_DUMP_DATA_ARRAY DataArray;
  ULONG                    Flags;
  ULONG                    MaxVirtMemSize;
  ULONG                    BugCheckCode;
  ULONG_PTR                BugCheckParameter1;
  ULONG_PTR                BugCheckParameter2;
  ULONG_PTR                BugCheckParameter3;
  ULONG_PTR                BugCheckParameter4;
} KBUGCHECK_TRIAGE_DUMP_DATA, *PKBUGCHECK_TRIAGE_DUMP_DATA;

Membres

DataArray

Pointeur vers une structure _KBUGCHECK_TRIAGE_DUMP_DATA . Il s’agit de la méthode utilisée par le rappel pour fournir le tableau de données de bloc de triage qu’il a créé.

Flags

Indicateurs passés dans le rappel.

KB_TRIAGE_DUMP_DATA_FLAG_BUGCHECK_ACTIVE 0x00000001

Indique que le rappel est appelé lors d’une vérification d’erreur. Actuellement, cet indicateur doit toujours être défini.

MaxVirtMemSize

Taille de mémoire virtuelle maximale en octets que le rappel est autorisé à ajouter au vidage. La taille cumulée des régions décrites dans le tableau de données ne doit pas dépasser cette taille.

BugCheckCode

Cette valeur indique au rappel quel code de vérification d’erreur a été passé à KeBugcheckEx. La routine de rappel peut utiliser ces informations pour décider s’il faut ajouter de la mémoire au fichier de vidage sur incident. Pour obtenir la liste complète des codes de case activée de bogues, consultez le fichier d’en-tête Bugcodes.h inclus dans le WDK.

BugCheckParameter1

Paramètre de vérification des bogues 1. Les paramètres de case activée de bogue informent le rappel des paramètres de vérification d’erreur qui ont été passés à KeBugcheckEx.

BugCheckParameter2

Paramètre de vérification des bogues 2. Les paramètres de case activée de bogue informent le rappel des paramètres de vérification d’erreur qui ont été passés à KeBugcheckEx.

BugCheckParameter3

Paramètre de vérification des bogues 3. Les paramètres de case activée de bogue informent le rappel des paramètres de vérification d’erreur qui ont été passés à KeBugcheckEx.

BugCheckParameter4

Paramètre de vérification des bogues 4. Les paramètres de case activée de bogue informent le rappel des paramètres de vérification d’erreur qui ont été passés à KeBugcheckEx.

Remarques

Le pilote reçoit une structure de ce type en tant que paramètre pour sa routine de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE .

À partir de la routine de rappel, le pilote appelle la fonction KeAddTriageDumpDataBlock pour modifier un tableau de données de vidage.

Configuration requise

Condition requise	Valeur
En-tête	wdm.h

Voir aussi

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

Partager via