INSTANCE_AGGREGATE_STANDARD_INFORMATION結構（fltuserstructures.h）

發行項
02/06/2025

呼叫端配置的 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 結構的位元組位移。如果沒有其他結構遵循此成員，則此成員為零。

Flags

指出篩選驅動程式是舊版篩選驅動程式還是小型篩選驅動程式。這個成員必須包含下列其中一個旗標。

旗	意義
FLTFL_IASI_IS_MINIFILTER	篩選驅動程式是迷你篩選驅動程式;使用聯集 MiniFilter 部分。
FLTFL_IASI_IS_LEGACYFILTER	篩選驅動程式是舊版篩選驅動程式;使用 union LegacyFilter 部分。

Type

具有下列成員的巢狀結構變數。

Type.MiniFilter

Type.MiniFilter.Flags

旗標的位掩碼，描述迷你篩選實例的屬性。以下是有效的旗標值。

旗	意義
FLTFL_IASIM_DETACHED_VOLUME	磁碟區目前未連結至記憶體堆疊。

Type.MiniFilter.FrameID

以零起始的索引，用來識別迷你篩選實例位於的篩選管理員框架。

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 開始，高度會根據驅動程式的負載順序群組指派給舊版篩選驅動程式。這可確保小型篩選驅動程式會在舊版篩選驅動程式的上方和下方適當分層，即使一或多個篩選驅動程式已依序載入。

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）	磁碟區支援卸除的寫入作業。