Share via


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エントリのバイト オフセット。 このメンバーの後に他のエントリがない場合、このメンバーは 0 になります。

Flags

フィルター ドライバーがレガシ フィルターかミニフィルターかを示します。 このメンバーは、次のいずれかの値である必要があります。

フラグ 説明
FLTFL_AGGREGATE_INFO_IS_MINIFILTER フィルターはミニフィルターです。共用体の MiniFilter 部分を使用します。
FLTFL_AGGREGATE_INFO_IS_LEGACYFILTER フィルターはレガシ フィルターです。共用体の LegacyFilter 部分を使用します。

Type

Type.MiniFilter

Type.MiniFilter.FrameID

現在のフレームの 0 から始まるインデックス。

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、FilterFindNextFilterGetInformationFltEnumerateFilterInformationFltGetFilterInformation などのルーチンにパラメーターとして渡されます。

この構造体は、LONGLONG (8 バイト) 境界に配置する必要があります。 バッファーにこれらの構造体が 2 つ以上含まれている場合、各エントリの NextEntryOffset 値 (最後の を除く) は 8 バイトの境界になります。

要件

要件
サポートされている最小のクライアント この構造は、Microsoft Windows Server 2003 SP1 と Windows XP SP2 とフィルター マネージャーのロールアップから使用できます。 Windows XP SP2 のフィルター マネージャー ロールアップ パッケージの詳細については、Microsoft サポート技術情報の「Windows XP SP2 のフィルター マネージャー ロールアップ パッケージ」914882記事を参照してください。
Header fltuserstructures.h (FltUser.h、FltKernel.h を含む)

こちらもご覧ください

FILTER_AGGREGATE_STANDARD_INFORMATION

FILTER_FULL_INFORMATION

FilterFindClose

FilterFindFirst

FilterFindNext

FilterGetInformation

FltEnumerateFilterInformation

FltGetFilterInformation