struttura FILTER_INITIALIZATION_DATA (ntdddump.h)

Articolo
08/07/2023

Il driver di filtro compila una struttura FILTER_INITIALIZATION_DATA e lo restituisce al driver di dump di arresto anomalo del sistema.

Sintassi

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;

Members

MajorVersion

Impostare su uno dei valori di versione principali seguenti:

DUMP_FILTER_MAJOR_VERSION_1 (0x1)

DUMP_FILTER_MAJOR_VERSION (0x2)

MinorVersion

Impostare su DUMP_FILTER_MINOR_VERSION.

DumpStart

Puntatore alla routine di inizializzazione del dump. Questa routine viene chiamata all'avvio del dump di arresto anomalo del sistema.

DumpWrite

Puntatore alla routine di scrittura. Questa routine viene chiamata prima di ogni richiesta di scrittura del dump di arresto anomalo del sistema.

DumpFinish

Puntatore alla routine di fine del dump. Questa routine viene chiamata al termine del dump di arresto anomalo del sistema.

DumpUnload

Puntatore alla routine di scaricamento del dump. Questa routine viene chiamata prima che il driver venga scaricato.

DumpData

Il driver di filtro può passare un puntatore ai dati di contesto interni in questo membro. Questo puntatore viene passato al driver di filtro in una struttura FILTER_EXTENSION durante ogni callback.

MaxPagesPerWrite

Numero massimo di pagine per ogni richiesta di lettura o scrittura del dump.

Flags

Set di flag per l'inizializzazione del filtro di dump. Questo valore è impostato su 0 o su quanto segue:

Valore	Significato
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	Il filtro dump supporta le letture di filtro e viene impostata una routine di callback di lettura per DumpRead. Questo flag è supportato a partire da Windows 8.
DUMP_FILTER_CRITICAL	L'inizializzazione del filtro non riesce immediatamente se la routine DriverEntry del driver del filtro dump non restituisce STATUS_SUCCESS. Questo flag è supportato a partire da Windows 8.

DumpRead

Puntatore alla routine di lettura. Questa routine viene chiamata dopo ogni richiesta di lettura del dump di arresto anomalo del sistema. Questo membro è disponibile a partire da Windows 8.

Commenti

Per consentire a un driver di filtro di dump di supportare il filtro di lettura, sono necessarie le impostazioni seguenti:

Il flag DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ è impostato in Flag.
MajorVersion è impostato su DUMP_FILTER_MAJOR_VERSION = 2.
Il puntatore DumpRead è impostato sulla routine di lettura del driver di filtro dump.

Se uno di questi membri non è impostato, il driver del filtro dump verrà contrassegnato come non supporta le letture dump dallo stack crashdump.