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

  • Статья

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
 Для параметра Length задано недопустимое значение. Это код ошибки.
STATUS_INSUFFICIENT_RESOURCES
 FltSetVolumeInformation столкнулся с ошибкой выделения пула. Это код ошибки.
STATUS_INVALID_INFO_CLASS
 Для FsInformationClass указано недопустимое значение. Это код ошибки.
STATUS_INVALID_PARAMETER
 Экземпляр подключен к сетевому тому. FltSetVolumeInformation нельзя использовать для задания сведений о томе сети. Это код ошибки.

Комментарии

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

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть fltkernel.h (включая Fltkernel.h)
Библиотека FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

См. также раздел

FILE_FS_CONTROL_INFORMATION

FILE_FS_LABEL_INFORMATION

FILE_FS_OBJECTID_INFORMATION

FltQueryVolumeInformation