FILTER_AGGREGATE_BASIC_INFORMATION 結構 (fltuserstructures.h)

發行項
02/29/2024

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 開始，即可使用此結構。 For more information on the filter manager rollup package for Windows XP SP2, see article 914882, "The filter manager rollup package for Windows XP SP2," in the Microsoft Knowledge Base.
標頭	fltuserstructures.h (包括 FltUser.h、FltKernel.h)