structure KBUGCHECK_SECONDARY_DUMP_DATA_EX (wdm.h)

Article
02/27/2024

La structure KBUGCHECK_SECONDARY_DUMP_DATA_EX décrit les données en plusieurs parties à écrire par KBUGCHECK_REASON_CALLBACK_ROUTINE routine de rappel au fichier de vidage sur incident.

Syntaxe

typedef struct _KBUGCHECK_SECONDARY_DUMP_DATA_EX {
  PVOID     InBuffer;
  ULONG     InBufferLength;
  ULONG     MaximumAllowed;
  GUID      Guid;
  PVOID     OutBuffer;
  ULONG     OutBufferLength;
  PVOID     Context;
  ULONG     Flags;
  ULONG     DumpType;
  ULONG     BugCheckCode;
  ULONG_PTR BugCheckParameter1;
  ULONG_PTR BugCheckParameter2;
  ULONG_PTR BugCheckParameter3;
  ULONG_PTR BugCheckParameter4;
} KBUGCHECK_SECONDARY_DUMP_DATA_EX, *PKBUGCHECK_SECONDARY_DUMP_DATA_EX;

Membres

InBuffer

Pointeur vers une mémoire tampon allouée par le système.

InBufferLength

Spécifie la taille de la mémoire tampon, en octets, spécifiée par le membre InBuffer .

MaximumAllowed

Spécifie la quantité maximale de données que la routine KBUGCHECK_REASON_CALLBACK_ROUTINE peut écrire dans le fichier de vidage sur incident.

Guid

Spécifie un GUID qui identifie les données de vidage sur incident du pilote. (Les pilotes doivent utiliser des GUID uniques pour marquer leurs données de vidage sur incident. Utilisez l’outil GuidGen.exe pour générer des GUID pour votre pilote.

OutBuffer

Pointeur vers la mémoire tampon où le pilote écrit ses données de vidage sur incident, ou NULL.

OutBufferLength

Spécifie la taille de la mémoire tampon, en octets, qui a été spécifiée par le membre OutBuffer .

Context

Contient des données de contexte privées pour l’utilisation exclusive de la routine de rappel. La routine de rappel peut définir ce membre sur n’importe quelle valeur. En règle générale, si la routine de rappel doit être appelée plusieurs fois, la routine définit ce membre pour qu’il pointe vers une mémoire tampon fournie par le pilote pendant l’appel initial. Lors des appels suivants, la routine de rappel peut lire le contenu précédent de cette mémoire tampon et mettre à jour son contenu. Avant l’appel initial à la routine de rappel, Context a la valeur NULL.

Flags

Contient des indicateurs qui décrivent la demande de page d’ajout. La routine de rappel doit définir la valeur de ce membre. Affectez à ce membre la valeur OR au niveau du bit d’un ou de plusieurs des bits d’indicateur suivants :

KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS

Indique que le membre Address contient une adresse virtuelle.

KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS

Indique que le membre Address contient une adresse physique.

KB_ADD_PAGES_FLAG_ADDITIONAL_RANGES_EXIST

Indique que la routine de rappel demande qu’elle soit appelée à nouveau afin qu’elle puisse ajouter d’autres pages.

La routine de rappel doit définir l’indicateur KB_ADD_PAGES_FLAG_VIRTUAL_ADDRESS ou l’indicateur KB_ADD_PAGES_FLAG_PHYSICAL_ADDRESS, mais pas les deux. Lors de l’entrée dans la routine de rappel, flags est initialisé à zéro.

DumpType

L’un des types de vidage suivants.

    DUMP_TYPE_INVALID           = -1,
    DUMP_TYPE_UNKNOWN           = 0,
    DUMP_TYPE_FULL              = 1,
    DUMP_TYPE_SUMMARY           = 2,
    DUMP_TYPE_HEADER            = 3,
    DUMP_TYPE_TRIAGE            = 4,
    DUMP_TYPE_BITMAP_FULL       = 5,
    DUMP_TYPE_BITMAP_KERNEL     = 6,
    DUMP_TYPE_AUTOMATIC         = 7

BugCheckCode

Contient un code de case activée de bogue, qui spécifie la raison de l’case activée du bogue. La routine de rappel peut utiliser ces informations pour décider s’il faut ajouter des pages 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 bogue case activée informent le rappel des paramètres de vérification des bogues qui ont été passés à KeBugcheckEx.

BugCheckParameter2

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

BugCheckParameter3

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

BugCheckParameter4

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

Remarques

Pour plus d’informations sur les routines de rappel des bogues case activée, consultez Écriture d’une routine de rappel de vérification des bogues.

Configuration requise

Condition requise	Valeur
En-tête	wdm.h

Voir aussi

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

Partager via