структура FILTER_INITIALIZATION_DATA (ntdddump.h)

Статья
02/29/2024

Драйвер фильтра заполняет структуру 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.

DumpRead

Указатель на подпрограмму чтения. Эта подпрограмма вызывается после каждого запроса на чтение аварийного дампа. Этот элемент доступен, начиная с Windows 8.

Флаг DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ задается в разделе Флаги.
MajorVersion имеет значение DUMP_FILTER_MAJOR_VERSION = 2.
Для указателя DumpRead задана подпрограмма чтения драйвера фильтра дампа.

Если какой-либо из этих элементов не задан, драйвер фильтра дампа будет помечен стеком аварийного дампа как не поддерживающий чтение дампа.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows Vista и Windows Server 2008.
Верхняя часть	ntdddump.h (включая Ntdddump.h)