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

Структура 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

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

Флаг	Значение
FLTFL_AGGREGATE_INFO_IS_MINIFILTER	Фильтр является минифильтром — используйте MiniFilter части объединения.
FLTFL_AGGREGATE_INFO_IS_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

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

Замечания

Структура FILTER_AGGREGATE_BASIC_INFORMATION передается в качестве параметра в подпрограммы, такие как FilterFindFirst, FilterFindNext, FilterGetInformation, FltEnumerateFilterInformationи FltGetFilterInformation.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Эта структура доступна начиная с microsoft Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2) с накопительным пакетом обновления 2 (SP2) диспетчера фильтров. Дополнительные сведения о пакете накопительного пакета диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) см. в статье 914882 "Пакет накопительного пакета обновления диспетчера фильтров для Windows XP с пакетом обновления 2 (SP2) в Базе знаний Майкрософт.
заголовка	fltuserstructures.h (include FltUser.h, FltKernel.h)

См. также

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FilterFindClose

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation