INSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体 (fltuserstructures.h)

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

呼び出し元によって割り当てられた INSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体には、ミニフィルタードライバーインスタンスまたはレガシフィルタードライバーに関する集計標準情報が含まれています。

構文

typedef struct _INSTANCE_AGGREGATE_STANDARD_INFORMATION {
  ULONG NextEntryOffset;
  ULONG Flags;
  union {
    struct {
      ULONG               Flags;
      ULONG               FrameID;
      FLT_FILESYSTEM_TYPE VolumeFileSystemType;
      USHORT              InstanceNameLength;
      USHORT              InstanceNameBufferOffset;
      USHORT              AltitudeLength;
      USHORT              AltitudeBufferOffset;
      USHORT              VolumeNameLength;
      USHORT              VolumeNameBufferOffset;
      USHORT              FilterNameLength;
      USHORT              FilterNameBufferOffset;
      ULONG               SupportedFeatures;
    } MiniFilter;
    struct {
      ULONG  Flags;
      USHORT AltitudeLength;
      USHORT AltitudeBufferOffset;
      USHORT VolumeNameLength;
      USHORT VolumeNameBufferOffset;
      USHORT FilterNameLength;
      USHORT FilterNameBufferOffset;
      ULONG  SupportedFeatures;
    } LegacyFilter;
  } Type;
} INSTANCE_AGGREGATE_STANDARD_INFORMATION, *PINSTANCE_AGGREGATE_STANDARD_INFORMATION;

メンバー

NextEntryOffset

バッファーに複数の構造体が存在する場合 は、次のINSTANCE_AGGREGATE_STANDARD_INFORMATION 構造体のバイトオフセット。他の構造体がこの構造体の後に存在しない場合、このメンバーは 0 になります。

Flags

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

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

Type

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

Type.MiniFilter

Type.MiniFilter.Flags

ミニフィルターインスタンスの属性を記述するフラグのビットマスク。有効なフラグ値を次に示します。

フラグ	説明
FLTFL_IASIM_DETACHED_VOLUME	現在、ボリュームはストレージスタックにアタッチされていません。

Type.MiniFilter.FrameID

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

Type.MiniFilter.VolumeFileSystemType

ミニフィルターインスタンスがアタッチされているファイルシステムの種類を識別します。このメンバーに指定できる値は、 FLT_FILESYSTEM_TYPEに一覧表示されます。

Type.MiniFilter.InstanceNameLength

ミニフィルターインスタンス名の長さ (バイト単位)。

Type.MiniFilter.InstanceNameBufferOffset

Unicode ミニフィルターインスタンス名文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.MiniFilter.AltitudeLength

ミニフィルターインスタンスの高度文字列の長さ (バイト単位)。

Type.MiniFilter.AltitudeBufferOffset

Unicode ミニフィルターインスタンス高度文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.MiniFilter.VolumeNameLength

ミニフィルターインスタンスがアタッチされているボリュームのボリューム名の長さ (バイト単位)。

Type.MiniFilter.VolumeNameBufferOffset

ミニフィルターインスタンスがアタッチされているボリュームの Unicode ボリューム名文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.MiniFilter.FilterNameLength

ミニフィルターインスタンスの派生元のミニフィルターのミニフィルター名の長さ (バイト単位)。

Type.MiniFilter.FilterNameBufferOffset

ミニフィルターインスタンスの派生元のミニフィルターの Unicode ミニフィルター名文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.MiniFilter.SupportedFeatures

ミニフィルターの SupportedFeatures レジストリ値で指定されているフィルターのサポートされている機能フラグ。サポートされている機能は、次のフラグのビットごとの OR の組み合わせです。

値	意味
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	ボリュームでは、オフロードされた読み取り操作がサポートされています。
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	ボリュームでは、オフロードされた書き込み操作がサポートされます。
SUPPORTED_FS_FEATURES_QUERY_OPEN (0x04)	ボリュームでは、クエリを開く操作がサポートされています。
SUPPORTED_FS_FEATURES_BYPASS_IO (0x08)	ボリュームは BypassIO をサポートしています。このフラグは、Windows 11 以降で使用できます。

Type.LegacyFilter

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

Type.LegacyFilter.Flags

レガシフィルターの属性を記述するフラグのビットマスク。有効なフラグ値を次に示します。

フラグ	説明
FLTFL_IASIL_DETACHED_VOLUME	現在、ボリュームはストレージスタックにアタッチされていません。

Type.LegacyFilter.AltitudeLength

レガシフィルター高度文字列の長さ (バイト単位)。

Type.LegacyFilter.AltitudeBufferOffset

Unicode レガシフィルター高度文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

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

Type.LegacyFilter.VolumeNameLength

レガシフィルターがアタッチされているボリュームのボリューム名の長さ (バイト単位)。

Type.LegacyFilter.VolumeNameBufferOffset

レガシフィルターがアタッチされているボリュームの Unicode ボリューム名文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.LegacyFilter.FilterNameLength

レガシフィルター名の長さ (バイト単位)。

Type.LegacyFilter.FilterNameBufferOffset

Unicode レガシフィルター名文字列の最初の文字のバイトオフセット (構造体の先頭を基準)。この文字列は NULL で終わるものではありません。

Type.LegacyFilter.SupportedFeatures

レガシフィルターでサポートされている機能フラグ。

サポートされている機能は、次のフラグのビットごとの OR の組み合わせです。

値	意味
SUPPORTED_FS_FEATURES_OFFLOAD_READ (0x01)	ボリュームでは、オフロードされた読み取り操作がサポートされています。
SUPPORTED_FS_FEATURES_OFFLOAD_WRITE (0x02)	ボリュームでは、オフロードされた書き込み操作がサポートされます。