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

Драйвер минифильтра, загруженный вспомогательным драйвером минифильтра, вызывая FltLoadFilter может выгрузить драйвер минифильтра, вызвав FltUnloadFilter.

Синтаксис

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

Параметры

[in] FilterName

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

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

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

Возвращаемый код	Описание
STATUS_FLT_DELETING_OBJECT	Был найден соответствующий драйвер минифильтра, но он уже оторвался. Это код ошибки.
STATUS_FLT_FILTER_NOT_FOUND	Не найден соответствующий драйвер минифильтра. Это код ошибки.

Замечания

Драйвер минифильтра, который зависит от другого драйвера минифильтра, может выгрузить этот минифильтратор, вызвав FltUnloadFilter. Эта подпрограмма выполняет поиск зарегистрированного драйвера минифильтра, имя службы которого соответствует заданному FilterName и вызывает подпрограмму драйвера minifilter FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK).

Если вспомогательный драйвер минифильтра не зарегистрировал подпрограмму FilterUnloadCallback, вызов FltUnloadFilter завершается ошибкой.

Драйвер минифильтра не может вызывать fltUnloadFilter для выгрузки.

Требования

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

См. также

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING