Функция 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 , и вызывает подпрограмму FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) этого драйвера минифильтра.

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

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

Требования

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

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

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING