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

Статья
08/07/2023

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

Синтаксис

typedef struct _FILTER_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG  Flags;
      ULONG  FrameID;
      ULONG  NumberOfInstances;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      USHORT FilterAltitudeLength;
      USHORT FilterAltitudeBufferOffset;
    } LegacyFilter;
  } Type;
} FILTER_AGGREGATE_STANDARD_INFORMATION, *PFILTER_AGGREGATE_STANDARD_INFORMATION;

Члены

NextEntryOffset

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

Flags

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

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

Type

Type.MiniFilter

Вложенная переменная структуры со следующими элементами:

Type.MiniFilter.Flags

В настоящее время для этого элемента не определены флаги.

Type.MiniFilter.FrameID

Отсчитываемый от нуля индекс, используемый для идентификации кадра диспетчера фильтров, в который находится минифильтр.

Type.MiniFilter.NumberOfInstances

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

Type.MiniFilter.FilterNameLength

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

Type.MiniFilter.FilterNameBufferOffset

Байтовое смещение (относительно начала структуры) первого символа строки имени минифильтра Юникода. Строка не заканчивается null.

Type.MiniFilter.FilterAltitudeLength

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

Type.MiniFilter.FilterAltitudeBufferOffset

Байтовое смещение (относительно начала структуры) первого символа строки высоты минифильтра Юникода. Строка не заканчивается null.

Type.LegacyFilter

Вложенная переменная структуры со следующими элементами:

Type.LegacyFilter.Flags

В настоящее время для этого элемента не определены флаги.

Type.LegacyFilter.FilterNameLength

Длина строки имени устаревшего фильтра (в байтах).

Type.LegacyFilter.FilterNameBufferOffset

Байтовое смещение (относительно начала структуры) первого символа строки имени устаревшего фильтра Юникода. Строка не заканчивается null.

Type.LegacyFilter.FilterAltitudeLength

Длина строки высоты устаревшего фильтра в байтах.

Type.LegacyFilter.FilterAltitudeBufferOffset

Байтовое смещение (относительно начала структуры) первого символа строки высоты устаревшего фильтра Юникода. Строка не заканчивается null.

Начиная с Windows Vista высоты назначаются устаревшим драйверам фильтров в зависимости от группы заказа нагрузки драйвера. Это гарантирует, что драйверы минифильтра будут правильно распределяться поверх и ниже устаревших драйверов фильтров, даже если один или несколько драйверов фильтров загружены не по порядку.

Структура FILTER_AGGREGATE_STANDARD_INFORMATION может быть выделена из выгружаемого или невыгружаемого пула. Эта структура передается в качестве параметра в подпрограммы, такие как:

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

Требования

Требование	Значение
Минимальная версия клиента	Эта структура доступна начиная с Windows Vista.
Верхняя часть	fltuserstructures.h (включая FltUser.h, FltKernel.h)