Функция 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 структуру, содержащую сведения о том, находится ли указанный драйвер в пути ввода-вывода для тома. Вызывающий объект должен хранить имя драйвера в структуре 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 структуру, содержащую сведения о размерах физического и логического сектора тома.

[out, optional] LengthReturned

Указатель на переменную, выделенную вызывающим объектом, которая получает размер в байтах, возвращаемых в буфере FsInformation. Этот параметр является необязательным и может быть null.

Возвращаемое значение

FltQueryVolumeInformationFile возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее:

Возвращаемый код	Описание
STATUS_VOLUME_DISMOUNTED	В настоящее время том не подключен. Это код ошибки.

Замечания

FltQueryVolumeInformationFile извлекает сведения о томе для заданного файла, каталога, устройства хранения или тома.

Если FileObject представляет собой открытое прямое устройство, можно указать только FileFsDeviceInformation в качестве значения FsInformationClass.

FltQueryVolumeInformationFile возвращает ноль в любом элементе структуры FILE_FS_XXX_INFORMATION, которая не поддерживается определенной файловой системой.

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	fltkernel.h (include Fltkernel.h)
библиотеки	FltMgr.lib
DLL	Fltmgr.sys
IRQL	PASSIVE_LEVEL