FILTER_AGGREGATE_STANDARD_INFORMATION 構造体 (fltuserstructures.h)

[アーティクル]
08/07/2023

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

Flags

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

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

Type

Type.MiniFilter

次のメンバーを持つ入れ子になった構造体変数:

Type.MiniFilter.Flags

現在、このメンバーに対して定義されているフラグはありません。

Type.MiniFilter.FrameID

ミニフィルターが含まれるフィルターマネージャーフレームを識別するために使用される 0 から始まるインデックス。

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 以降では、ドライバーの読み込み順序グループに基づいて、レガシフィルタードライバーに高度が割り当てられます。これにより、1 つ以上のフィルタードライバーが順を外して読み込まれている場合でも、ミニフィルタードライバーがレガシフィルタードライバーの上と下に適切にレイヤー化されます。

注釈

FILTER_AGGREGATE_STANDARD_INFORMATION構造体は、ページプールまたは非ページプールから割り当てることができます。この構造体は、次のようなルーチンにパラメーターとして渡されます。

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

要件

要件	値
サポートされている最小のクライアント	この構造は、Windows Vista 以降で使用できます。
Header	fltuserstructures.h (FltUser.h、FltKernel.h を含む)