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

  • Статья

FltDetachVolume отсоединяет экземпляр драйвера минифильтра от тома.

Синтаксис

NTSTATUS FLTAPI FltDetachVolume(
  [in, out]      PFLT_FILTER      Filter,
  [in, out]      PFLT_VOLUME      Volume,
  [in, optional] PCUNICODE_STRING InstanceName
);

Параметры

[in, out] Filter

Непрозрачный указатель фильтра для вызывающего объекта. Этот параметр является обязательным и не может иметь значение NULL.

[in, out] Volume

Указатель непрозрачного тома для тома, к которому присоединен экземпляр. Этот параметр является обязательным и не может иметь значение NULL.

[in, optional] InstanceName

Указатель на структуру UNICODE_STRING , содержащую имя удаляемого экземпляра. Этот параметр является необязательным и может иметь значение NULL. Если он имеет значение NULL, удаляется экземпляр с наибольшим соответствием.

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

Функция FltDetachVolume возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата Описание
STATUS_FLT_DELETING_OBJECT
 FltDetachVolume обнаружил соответствующий экземпляр, но экземпляр сносится. Это код ошибки.
STATUS_FLT_INSTANCE_NOT_FOUND
 Соответствующий экземпляр не найден. Это код ошибки.

Комментарии

FltDetachVolume отключает экземпляр драйвера минифильтра от тома и удаляет экземпляр.

Чтобы подключить экземпляр драйвера минифильтра к тому, вызовите FltAttachVolume или FltAttachVolumeAtAltitude.

Чтобы сравнить высоту двух экземпляров драйвера минифильтра, подключенных к одному тому, вызовите FltCompareInstanceAltitudes.

Требования

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

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

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName