FILTER_INITIALIZATION_DATA structure (ntdddump.h)

Article
02/29/2024

Le pilote de filtre remplit une structure de FILTER_INITIALIZATION_DATA et la retourne au pilote de vidage sur incident.

Syntaxe

typedef struct _FILTER_INITIALIZATION_DATA {
  ULONG        MajorVersion;
  ULONG        MinorVersion;
  PDUMP_START  DumpStart;
  PDUMP_WRITE  DumpWrite;
  PDUMP_FINISH DumpFinish;
  PDUMP_UNLOAD DumpUnload;
  PVOID        DumpData;
  ULONG        MaxPagesPerWrite;
  ULONG        Flags;
  PDUMP_READ   DumpRead;
} FILTER_INITIALIZATION_DATA, *PFILTER_INITIALIZATION_DATA;

Membres

MajorVersion

Définissez sur l’une des valeurs de version principales suivantes :

DUMP_FILTER_MAJOR_VERSION_1 (0x1)

DUMP_FILTER_MAJOR_VERSION (0x2)

MinorVersion

Définissez sur DUMP_FILTER_MINOR_VERSION.

DumpStart

Pointeur vers la routine d’initialisation de vidage. Cette routine est appelée lorsque le vidage sur incident démarre.

DumpWrite

Pointeur vers la routine d’écriture. Cette routine est appelée avant chaque demande d’écriture de vidage sur incident.

DumpFinish

Pointeur vers la routine de fin de vidage. Cette routine est appelée lorsque le vidage sur incident est terminé.

DumpUnload

Pointeur vers la routine de déchargement de vidage. Cette routine est appelée avant le déchargement du pilote.

DumpData

Le pilote de filtre peut passer un pointeur vers des données de contexte internes dans ce membre. Ce pointeur est repassé au pilote de filtre dans une structure FILTER_EXTENSION lors de chaque rappel.

MaxPagesPerWrite

Nombre maximal de pages pour chaque demande de lecture ou d’écriture de vidage.

Flags

Ensemble d’indicateurs pour l’initialisation du filtre de vidage. Cette valeur est définie sur 0 ou ce qui suit :

Valeur	Signification
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	Le filtre de vidage prend en charge le filtrage des lectures, et une routine de rappel de lecture est définie pour DumpRead. Cet indicateur est pris en charge à partir de Windows 8.
DUMP_FILTER_CRITICAL	L’initialisation du filtre échoue immédiatement si la routine DriverEntry du pilote de filtre de vidage ne retourne pas STATUS_SUCCESS. Cet indicateur est pris en charge à partir de Windows 8.

DumpRead

Pointeur vers la routine de lecture. Cette routine est appelée après chaque demande de lecture de vidage sur incident. Ce membre est disponible à partir de Windows 8.

Remarques

Pour qu’un pilote de filtre de vidage prend en charge le filtrage en lecture, les paramètres suivants sont requis :

L’indicateur DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ est défini dans Indicateurs.
MajorVersion est défini sur DUMP_FILTER_MAJOR_VERSION = 2.
Le pointeur DumpRead est défini sur la routine de lecture du pilote de filtre de vidage.

Si l’un de ces membres n’est pas défini, le pilote de filtre de vidage est marqué comme ne prenant pas en charge les lectures de vidage par la pile crashdump.