KBUGCHECK_ADD_PAGES structure (wdm.h)

La structure KBUGCHECK_ADD_PAGES décrit une ou plusieurs pages de données fournies par le pilote à écrire par une fonction de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE dans le fichier de vidage sur incident.

Syntaxe

typedef struct _KBUGCHECK_ADD_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_ADD_PAGES, *PKBUGCHECK_ADD_PAGES;

Membres

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. Définissez ce membre sur le ou au niveau du bit d’un ou 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, les indicateurs sont initialisés à zéro.

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 d’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.

Address

Spécifie l’adresse physique ou virtuelle de la ou des pages auxquelles la routine de rappel demande d’être ajoutée au fichier de vidage sur incident.

Count

Spécifie le nombre de pages contiguës à ajouter au fichier de vidage sur incident, à partir de l’adresse virtuelle ou physique spécifiée par le membre Address . Si Nombre> 1 et Adresse est une adresse virtuelle, les pages sont contiguës dans l’espace mémoire virtuel. Si Nombre> 1 et Adresse est une adresse physique, les pages sont contiguës dans l’espace mémoire physique. La routine de rappel peut définir ce membre sur zéro pour indiquer qu’il n’a pas besoin d’ajouter de pages au fichier de vidage sur incident.

Remarques

Dans un appel à la routine de rappel KbCallbackAddPages , le système d’exploitation définit le paramètre Reason sur KbCallbackAddPages et définit le paramètre ReasonSpecificData pour qu’il pointe vers une structure KBUGCHECK_ADD_PAGES .

Pour plus d’informations sur l’utilisation de cette structure, consultez Écriture d’une routine de rappel de vérification des bogues et KBUGCHECK_REASON_CALLBACK_ROUTINE fonction de rappel.

Configuration requise

Voir aussi

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