FltUnloadFilter 函数 (fltkernel.h)

通过调用 FltLoadFilter 加载支持微筛选器驱动程序的微筛选器驱动程序可以通过调用 FltUnloadFilter 来卸载微筛选器驱动程序。

语法

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

参数

[in] FilterName

指向包含传递给 FltLoadFilter 的微筛选器驱动程序服务名称的UNICODE_STRING结构的指针。

返回值

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)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

另请参阅

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING