structure KBUGCHECK_REMOVE_PAGES (wdm.h)

La structure KBUGCHECK_REMOVE_PAGES décrit une ou plusieurs pages de données fournies par le pilote à supprimer par une routine de rappel KBUGCHECK_REASON_CALLBACK_ROUTINE du fichier de vidage sur incident.

Syntaxe

typedef struct _KBUGCHECK_REMOVE_PAGES {
  PVOID     Context;
  ULONG     Flags;
  ULONG     BugCheckCode;
  ULONG_PTR Address;
  ULONG_PTR Count;
} KBUGCHECK_REMOVE_PAGES, *PKBUGCHECK_REMOVE_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 suppression de page. 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_FEATURE_SHIFT       4

KB_REMOVE_PAGES_FEATURE_SHIFT    4

KB_ADD_PAGES_FEATURE_MASK        (0xF << KB_ADD_PAGES_FEATURE_SHIFT)

KB_REMOVE_PAGES_FEATURE_MASK     (0xF << (KB_ADD_PAGES_FEATURE_SHIFT + KB_REMOVE_PAGES_FEATURE_SHIFT))

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.

Address

Spécifie l’adresse physique ou virtuelle de la ou des pages auxquelles la routine de rappel demande la suppression du fichier de vidage sur incident.

Count

Spécifie le nombre de pages contiguës à supprimer du 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 de 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 de supprimer des pages du fichier de vidage sur incident.

Remarques

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

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