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 匹配,并调用该微型筛选器驱动程序的 FilterUnloadCallbackPFLT_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