ZwQueryVolumeInformationFile 函数 (ntddk.h)
ZwQueryVolumeInformationFile 例程检索与给定文件、目录、存储设备或卷关联的卷的相关信息。
语法
NTSYSAPI NTSTATUS ZwQueryVolumeInformationFile(
[in] HANDLE FileHandle,
[out] PIO_STATUS_BLOCK IoStatusBlock,
[out] PVOID FsInformation,
[in] ULONG Length,
[in] FS_INFORMATION_CLASS FsInformationClass
);
参数
[in] FileHandle
ZwCreateFile 或 ZwOpenFile 为正在请求卷信息的打开文件、目录、存储设备或卷返回的文件对象的句柄。
[out] IoStatusBlock
指向 IO_STATUS_BLOCK 结构的指针，该结构接收最终完成状态和有关查询操作的信息。 对于返回数据的成功调用，写入 FsInformation 缓冲区的字节数将在结构的 Information 成员中返回。
[out] FsInformation
指向调用方分配的缓冲区的指针，该缓冲区接收有关卷的所需信息。 缓冲区中返回的信息的结构由 FsInformationClass 参数定义。
[in] Length
FsInformation 指向的缓冲区的大小（以字节为单位）。 调用方应根据给定的 FsInformationClass 设置此参数。
[in] FsInformationClass
要返回的有关卷的信息的类型。 将此成员设置为以下 FS_INFORMATION_CLASS 枚举值之一。
| 值 | 含义 |
|---|---|
| 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 结构中，然后才能调用 ZwQueryVolumeInformationFile。 |
| FileFsFullSizeInformation | 返回一个 FILE_FS_FULL_SIZE_INFORMATION 结构，其中包含有关卷上可用空间总量的信息。 |
| FileFsObjectIdInformation | 返回包含卷的文件系统特定对象 ID 信息的 FILE_FS_OBJECTID_INFORMATION 结构。 请注意，这与操作系统分配的基于 (GUID) 唯一卷名称不同。 |
| FileFsSizeInformation | 返回一个 FILE_FS_SIZE_INFORMATION 结构，其中包含与调用线程关联的用户可用的卷空间量的相关信息。 |
| FileFsVolumeInformation | 返回一个 FILE_FS_VOLUME_INFORMATION ，其中包含卷标签、序列号和创建时间等有关卷的信息。 |
| FileFsSectorSizeInformation | 返回一个 FILE_FS_SECTOR_SIZE_INFORMATION 结构，其中包含有关卷的物理扇区大小和逻辑扇区大小的信息。 |
返回值
ZwQueryVolumeInformationFile 返回STATUS_SUCCESS或适当的错误状态。
注解
ZwQueryVolumeInformationFile 检索与给定文件、目录、存储设备或卷关联的卷的相关信息。
如果 FileHandle 表示直接打开的设备，则只能将 FileFsDeviceInformation 指定为 FsInformationClass 的值。
ZwQueryVolumeInformationFile 在文件系统不支持的 FILE_XXX_INFORMATION 结构的任何成员中返回零。
有关其他文件信息查询例程的信息，请参阅 文件对象。
微筛选器应使用 FltQueryVolumeInformationFile 而不是 ZwQueryVolumeInformationFile。
ZwQueryVolumeInformationFile 的调用方必须在 IRQL = PASSIVE_LEVEL 且启用了特殊内核 APC 的情况下运行。
如果在用户模式下调用 ZwQueryVolumeInformationFile 函数，则应使用名称“NtQueryVolumeInformationFile”而不是“ZwQueryVolumeInformationFile”。
对于来自内核模式驱动程序的调用，Windows Native System Services 例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。 有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅 使用本机系统服务例程的 Nt 和 Zw 版本。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 通用 |
| 标头 | ntddk.h (包括 Ntifs.h、Ntddk.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL (请参阅“备注”部分) |
| DDI 符合性规则 | HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm) |
另请参阅
FILE_FS_DRIVER_PATH_INFORMATION