Функция FltSetVolumeInformation (fltkernel.h)

Статья
02/06/2025

FltSetVolumeInformation изменяет различные виды сведений о томе, к которому подключен данный экземпляр.

Синтаксис

NTSTATUS FLTAPI FltSetVolumeInformation(
  [in]  PFLT_INSTANCE        Instance,
  [out] PIO_STATUS_BLOCK     Iosb,
  [out] PVOID                FsInformation,
  [in]  ULONG                Length,
  [in]  FS_INFORMATION_CLASS FsInformationClass
);

Параметры

[in] Instance

Указатель непрозрачного экземпляра для экземпляра драйвера мини-фильтра, присоединенного к тому.

[out] Iosb

Указатель на структуру IO_STATUS_BLOCK, которая получает окончательное состояние завершения и сведения об операции.

[out] FsInformation

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

[in] Length

Размер в байтах буфера, на который FsInformation. Вызывающий объект должен задать этот параметр в соответствии с заданным FsInformationClass. Например, если значение FsInformationClass — FileFsControlInformation, длина должна быть не менее sizeof(FILE_FS_CONTROL_INFORMATION).

[in] FsInformationClass

Тип сведений, которые нужно задать для тома. Одно из следующих.

Ценность	Значение
FileFsControlInformation	Задайте FILE_FS_CONTROL_INFORMATION для тома.
FileFsLabelInformation	Задайте FILE_FS_LABEL_INFORMATION для тома.
FileFsObjectIdInformation	Задайте FILE_FS_OBJECTID_INFORMATION для тома.

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

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

Возвращаемый код	Описание
STATUS_INFO_LENGTH_MISMATCH	Недопустимое значение было указано для длины. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES	FltSetVolumeInformation возникла ошибка выделения пула. Это код ошибки.
STATUS_INVALID_INFO_CLASS	Недопустимое значение было указано для FsInformationClass. Это код ошибки.
STATUS_INVALID_PARAMETER	Экземпляр подключен к сетевому тому. FltSetVolumeInformation нельзя использовать для задания сведений о томе сети. Это код ошибки.

Замечания

Чтобы запросить сведения о томе, вызовите FltQueryVolumeInformation.

Требования

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

См. также

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation

Поделиться через