FILTER_INITIALIZATION_DATA 结构 (ntdddump.h)

项目
08/07/2023

筛选器驱动程序填充 FILTER_INITIALIZATION_DATA 结构，并将其返回到故障转储驱动程序。

语法

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;

成员

MajorVersion

设置为以下主要版本值之一：

DUMP_FILTER_MAJOR_VERSION_1 (0x1)

DUMP_FILTER_MAJOR_VERSION (0x2)

MinorVersion

设置为 DUMP_FILTER_MINOR_VERSION。

DumpStart

指向转储初始化例程的指针。故障转储开始时会调用此例程。

DumpWrite

指向写入例程的指针。在每个故障转储写入请求之前调用此例程。

DumpFinish

指向转储完成例程的指针。故障转储完成后，将调用此例程。

DumpUnload

指向转储卸载例程的指针。在卸载驱动程序之前调用此例程。

DumpData

筛选器驱动程序可以将指针传递到此成员中的内部上下文数据。在每个回调期间，此指针在 FILTER_EXTENSION 结构中传递回筛选器驱动程序。

MaxPagesPerWrite

每个转储读取或写入请求的最大页数。

Flags

转储筛选器初始化的一组标志。此值设置为 0 或以下值：

值	含义
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	转储筛选器支持筛选读取，并且为 DumpRead 设置了读取回调例程。从 Windows 8 开始支持此标志。
DUMP_FILTER_CRITICAL	如果转储筛选器驱动程序的 DriverEntry 例程未返回STATUS_SUCCESS，则立即使筛选器初始化失败。从 Windows 8 开始支持此标志。