FILTER_AGGREGATE_BASIC_INFORMATION结构 (fltuserstructures.h)

项目
08/07/2023

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	筛选器是旧筛选器 - 使用联合的 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 SP1 和带有筛选器管理器汇总的 Windows XP SP2 开始可用。有关适用于 Windows XP SP2 的筛选器管理器汇总包的详细信息，请参阅 Microsoft 知识库中的文章914882“适用于 Windows XP SP2 的筛选器管理器汇总包”。
标头	fltuserstructures.h (包括 FltUser.h、FltKernel.h)