структура FILTER_AGGREGATE_BASIC_INFORMATION (fltuserstructures.h)

Статья
02/29/2024

Структура FILTER_AGGREGATE_BASIC_INFORMATION содержит основные сведения для драйвера минифильтра или устаревшего фильтра.

Синтаксис

typedef struct _FILTER_AGGREGATE_BASIC_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_BASIC_INFORMATION, *PFILTER_AGGREGATE_BASIC_INFORMATION;

Члены

NextEntryOffset

Байтовое смещение следующей записи FILTER_AGGREGATE_BASIC_INFORMATION, если в буфере присутствует несколько записей. Этот элемент равен нулю, если другие записи не следуют за этим элементом.

Flags

Указывает, является ли драйвер фильтра устаревшим фильтром или минифильтром. Этот элемент должен иметь одно из следующих значений.

Flag	Значение
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	Фильтр является минифильтром. Используйте часть MiniFilter объединения.
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER	Фильтр является устаревшим фильтром. Используйте часть LegacyFilter объединения.

Type

Type.MiniFilter

Type.MiniFilter.FrameID

Отсчитываемый от нуля индекс текущего кадра.

Type.MiniFilter.NumberOfInstances

Количество экземпляров, которые в настоящее время существуют для мини-фильтра.

Type.MiniFilter.FilterNameLength

Длина (в байтах) имени фильтра.

Type.MiniFilter.FilterNameBufferOffset

Байтовое смещение первого символа строки имени фильтра.

Type.MiniFilter.FilterAltitudeLength

Длина строки высоты минифильтра в байтах.

Type.MiniFilter.FilterAltitudeBufferOffset

Байтовое смещение первого символа строки высоты минифильтра.

Type.LegacyFilter

Type.LegacyFilter.FilterNameLength

Длина (в байтах) имени фильтра.

Type.LegacyFilter.FilterNameBufferOffset

Байтовое смещение первого символа строки имени фильтра.

Эта структура должна быть выровнена по границе LONGLONG (8 байт). Если буфер содержит две или более из этих структур, значение NextEntryOffset в каждой записи, за исключением последней, попадает на 8-байтовую границу.

Требования

Требование	Значение
Минимальная версия клиента	Эта структура доступна начиная с Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2) с накопительным пакетом управления фильтрами. Дополнительные сведения о накопительном пакете диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) см. в статье 914882 "Накопительный пакет диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) в базе знаний Майкрософт.
Верхняя часть	fltuserstructures.h (включая FltUser.h, FltKernel.h)

Требование

Значение

Минимальная версия клиента

Эта структура доступна начиная с Microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2) с накопительным пакетом управления фильтрами. Дополнительные сведения о накопительном пакете диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) см. в статье 914882 "Накопительный пакет диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) в базе знаний Майкрософт.

Верхняя часть

fltuserstructures.h (включая FltUser.h, FltKernel.h)