FltQueryVolumeInformationFile 函数 (fltkernel.h)

项目
08/07/2023

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 结构，其中包含卷的特定于文件系统的对象 ID 信息。请注意，这与操作系统分配的基于 (GUID) 唯一卷名称不同。
FileFsSizeInformation	返回一个 FILE_FS_SIZE_INFORMATION 结构，其中包含与调用线程关联的用户可用的卷上的空间量的相关信息。
FileFsVolumeInformation	返回一个 FILE_FS_VOLUME_INFORMATION ，其中包含卷标签、序列号和创建时间等有关卷的信息。
FileFsSectorSizeInformation	返回一个 FILE_FS_SECTOR_SIZE_INFORMATION 结构，其中包含有关卷的物理扇区大小和逻辑扇区大小的信息。