FILTER_VOLUME_STANDARD_INFORMATION結構 (fltuserstructures.h)

發行項
02/29/2024

呼叫端配置的FILTER_VOLUME_STANDARD_INFORMATION結構包含磁碟區的資訊。

語法

typedef struct _FILTER_VOLUME_STANDARD_INFORMATION {
  ULONG               NextEntryOffset;
  ULONG               Flags;
  ULONG               FrameID;
  FLT_FILESYSTEM_TYPE FileSystemType;
  USHORT              FilterVolumeNameLength;
  WCHAR               FilterVolumeName[1];
} FILTER_VOLUME_STANDARD_INFORMATION, *PFILTER_VOLUME_STANDARD_INFORMATION;

成員

NextEntryOffset

如果緩衝區中有多個結構，則為下一個FILTER_VOLUME_STANDARD_INFORMATION結構的唯讀位移，以位元組為單位。如果沒有其他結構遵循這個成員，則這個成員為零。

Flags

描述磁碟區屬性之系統定義旗標的唯讀位掩碼。以下是有效的旗標值。

旗標	意義
FLTFL_VSI_DETACHED_VOLUME	中的磁碟區目前未連結至記憶體堆疊。

FrameID

唯讀成員，用來識別磁碟區所在的篩選管理員框架。

FileSystemType

唯讀成員，用來識別磁碟區上所使用的文件系統類型。此成員的可能值列在 FLT_FILESYSTEM_TYPE中。

FilterVolumeNameLength

磁碟區名稱的唯讀長度，以位元組為單位。

FilterVolumeName[1]

FilterVolumeNameLength 長度之磁碟區的唯讀名稱。這個 Unicode 字串不是 NULL 終止。

備註

篩選管理員列舉例程，例如 FltEnumerateVolumeInformation，可以使用類型為 FILTER_VOLUME_STANDARD_INFORMATION 的緩衝區填滿緩衝區，其中每個結構都代表篩選管理員已知的磁碟區。此結構清單可以包含多個具有相同名稱的磁碟區。如需詳細資訊，請參閱瞭解具有重複磁碟區名稱的磁碟區列舉。

FILTER_VOLUME_STANDARD_INFORMATION 結構必須對齊 LONGLONG (8 位元組) 界限。如果緩衝區包含這兩個以上的結構，則每個專案中的 NextEntryOffset 值都落在 8 位元組界限上。

您可以從分頁或非分頁集區配置FILTER_VOLUME_STANDARD_INFORMATION結構。