FltQueryVolumeInformationFile 函式 (fltkernel.h)

發行項
02/26/2024

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結構。請注意，這與操作系統指派的唯一磁碟區名稱 (GUID 型) 不同。
FileFsSizeInformation	傳回 FILE_FS_SIZE_INFORMATION 結構，其中包含與呼叫線程相關聯之使用者可用磁碟區空間量的相關信息。
FileFsVolumeInformation	傳回 FILE_FS_VOLUME_INFORMATION ，其中包含磁碟區標籤、序號和建立時間等磁碟區的相關信息。
FileFsSectorSizeInformation	傳回 FILE_FS_SECTOR_SIZE_INFORMATION 結構，其中包含磁碟區之實體和邏輯扇區大小的相關信息。