FltQueryVolumeInformationFile 函式（fltkernel.h）

發行項
02/06/2025

FltQueryVolumeInformationFile 擷取指定檔案、目錄、儲存裝置或磁碟區的磁碟區資訊。

語法

NTSTATUS FLTAPI FltQueryVolumeInformationFile(
  [in]            PFLT_INSTANCE        Instance,
  [in]            PFILE_OBJECT         FileObject,
  [out]           PVOID                FsInformation,
  [in]            ULONG                Length,
  [in]            FS_INFORMATION_CLASS FsInformationClass,
  [out, optional] PULONG               LengthReturned
);

參數

[in] Instance

呼叫端的不透明實例指標。這是必要參數，而且無法 NULL。

[in] FileObject

開啟檔案、目錄、儲存裝置或磁碟區的檔案物件指標。這是必要參數，而且無法 NULL。

[out] FsInformation

接收檔案相關信息的呼叫端配置緩衝區指標。 FsInformationClass 參數會指定資訊的類型。這是必要參數，而且無法 NULL。

[in] Length

大小，以位元組為單位，FsInformation 緩衝區。

[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 結構，才能呼叫 fltQueryVolumeInformationFile。
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 結構，其中包含磁碟區之實體和邏輯扇區大小的相關信息。