FltQueryVolumeInformation 函式（fltkernel.h）

發行項
02/06/2025

FltQueryVolumeInformation 例程會擷取指定實例所附加之磁碟區的相關信息。

語法

NTSTATUS FLTAPI FltQueryVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

參數

[in] Instance

附加至磁碟區之迷你篩選驅動程序實例的不透明實例指標。

[out] Iosb

呼叫端配置的IO_STATUS_BLOCK結構的指標，可接收查詢作業的最終完成狀態和相關信息。對於傳回數據的成功呼叫，寫入至 FsInformation 緩衝區的位元組數目會傳回結構 Information 成員中。

[out] FsInformation

呼叫端配置的緩衝區指標，可接收磁碟區的相關所需資訊。緩衝區中傳回的信息結構是由 FsInformationClass 參數所定義。

[in] Length

FsInformation 指向之緩衝區的大小，以位元組為單位。呼叫端應該根據指定的 FsInformationClass來設定此參數。例如，如果 FsInformationClass 的值為 FileFsControlInformation，Length 至少必須是 sizeof（FILE_FS_CONTROL_INFORMATION）。

[in] FsInformationClass

所要求的信息類型。下列其中一個值。

價值	意義
FileFsAttributeInformation	傳回 FILE_FS_ATTRIBUTE_INFORMATION 結構，其中包含負責磁碟區之文件系統的屬性資訊。
FileFsControlInformation	傳回包含磁碟區檔系統控制資訊的 FILE_FS_CONTROL_INFORMATION 結構。
FileFsDeviceInformation	傳回包含磁碟區裝置資訊的 FILE_FS_DEVICE_INFORMATION 結構。
FileFsDriverPathInformation	傳回 FILE_FS_DRIVER_PATH_INFORMATION 結構，其中包含指定驅動程式是否位於磁碟區 I/O 路徑中的資訊。呼叫者必須先將驅動程式的名稱儲存到 FILE_FS_DRIVER_PATH_INFORMATION 結構，才能呼叫 FltQueryVolumeInformation。
FileFsFullSizeInformation	傳回 FILE_FS_FULL_SIZE_INFORMATION 結構，其中包含磁碟區上可用空間總量的相關信息。
FileFsObjectIdInformation	傳回包含磁碟區檔系統特定物件標識碼資訊的 FILE_FS_OBJECTID_INFORMATION 結構。請注意，這與作系統指派的唯一磁碟區名稱不同。注意這個值對快照集磁碟區無效。
FileFsSizeInformation	傳回 FILE_FS_SIZE_INFORMATION 結構，其中包含與呼叫線程相關聯之使用者可用之磁碟區空間量的相關信息。
FileFsVolumeInformation	傳回 FILE_FS_VOLUME_INFORMATION，其中包含磁碟區卷標、序號和建立時間等磁碟區的相關信息。
FileFsSectorSizeInformation	傳回 FILE_FS_SECTOR_SIZE_INFORMATION 結構，其中包含磁碟區之實體和邏輯扇區大小的相關信息。

傳回值

FltQueryVolumeInformation 例程會傳回 STATUS_SUCCESS 或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	描述
STATUS_INSUFFICIENT_RESOURCES	FltQueryVolumeInformation 發生集區配置失敗。這是錯誤碼。
STATUS_INVALID_INFO_CLASS	FsInformationClass指定了無效的值。這是錯誤碼。
STATUS_INVALID_PARAMETER	實例會連結至網路磁碟區。 FltQueryVolumeInformation 無法用來查詢網路磁碟區資訊。這是錯誤碼。

言論

基礎文件系統不支援的 FILE_XXX_INFORMATION 結構中的欄位會設定為零。

若要變更磁碟區的相關信息，請呼叫 FltSetVolumeInformation。

若要取得指定磁碟區的磁碟區屬性資訊，請呼叫 FltGetVolumeProperties。

若要取得指定磁碟區的磁碟區名稱，請呼叫 FltGetVolumeName。

若要取得指定磁碟區的磁碟區 GUID 名稱，請呼叫 fltGetVolumeGuidName 。

要求

要求	價值
最低支援的用戶端	適用於 SP4 的 Microsoft Windows 2000 更新匯總 1、Service Pack 2 的 Windows XP、Windows Server 2003 SP1 和更新版本的 Windows作系統中提供及支援。 Windows 2000 SP4 和舊版 Windows作系統無法使用或支援。
目標平臺	普遍
標頭	fltkernel.h （包括 FltKernel.h）
連結庫	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL