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