FILTER_AGGREGATE_STANDARD_INFORMATION 结构 (fltuserstructures.h)

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

指示筛选器驱动程序是旧筛选器还是微筛选器。 此成员必须是以下值之一。

标志	含义
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

相对于 Unicode 微筛选器名称字符串第一个字符的结构) 开头的字节偏移量 (。 字符串不是以 NULL 结尾的。

Type.MiniFilter.FilterAltitudeLength

微筛选器海拔字符串的长度（以字节为单位）。

Type.MiniFilter.FilterAltitudeBufferOffset

相对于 Unicode 小筛选器海拔字符串第一个字符的结构) 的开头，字节偏移量 (。 字符串不是以 NULL 结尾的。

Type.LegacyFilter

具有以下成员的嵌套结构变量：

Type.LegacyFilter.Flags

当前没有为此成员定义标志。

Type.LegacyFilter.FilterNameLength

旧筛选器名称字符串的长度（以字节为单位）。

Type.LegacyFilter.FilterNameBufferOffset

相对于 Unicode 旧筛选器名称字符串的第一个字符的结构) 开头，字节偏移量 (。 字符串不是以 NULL 结尾的。

Type.LegacyFilter.FilterAltitudeLength

旧版筛选器高度字符串的长度（以字节为单位）。

Type.LegacyFilter.FilterAltitudeBufferOffset

相对于 Unicode 旧版筛选器海拔字符串第一个字符的结构) 开头的字节偏移量 (。 字符串不是以 NULL 结尾的。

从 Windows Vista 开始，根据驱动程序的加载顺序组将海拔高度分配给旧版筛选器驱动程序。 这可确保微筛选器驱动程序在旧筛选器驱动程序的上方和下方正确分层，即使一个或多个筛选器驱动程序的加载顺序不正常。

注解

可以从分页池或非分页池中分配FILTER_AGGREGATE_STANDARD_INFORMATION结构。 此结构作为参数传递给例程，例如：

• FilterFindFirst

• FilterFindNext

• FilterGetInformation

• FltEnumerateFilterInformation

• FltGetFilterInformation

FILTER_AGGREGATE_STANDARD_INFORMATION结构必须在 LONGLONG (8 字节) 边界上对齐。 如果缓冲区包含两个或多个这些结构，则每个条目中的 NextEntryOffset 值位于 8 字节边界上。

要求

要求	值
最低受支持的客户端	此结构从 Windows Vista 开始可用。
标头	fltuserstructures.h (包括 FltUser.h、FltKernel.h)

另请参阅

FILTER_AGGREGATE_BASIC_INFORMATION

FILTER_FULL_INFORMATION

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation