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

Статья
02/06/2025

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 (include Fltkernel.h)
библиотеки	FltMgr.lib
IRQL	<= APC_LEVEL

См. также

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltGetVolumeInstanceFromName

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