INSTANCE_AGGREGATE_STANDARD_INFORMATION結構 (fltuserstructures.h)

發行項
02/26/2024

呼叫端配置的 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	篩選驅動程式是舊版篩選驅動程式;使用等位的 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

位元移 (相對於衍生迷你篩選實例之 Minifilter 實例衍生來源之 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)	磁碟區支援卸除的寫入作業。