FltGetFilterFromName 函数（fltkernel.h）

项目
02/06/2025

FltGetFilterFromName 例程返回已注册的微型筛选器驱动程序的不透明筛选器指针，该驱动程序的名称与 FilterName 参数中的值匹配。

语法

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

参数

[in] FilterName

指向包含微型筛选器驱动程序名称的 UNICODE_STRING 结构的指针。（名称比较不区分大小写。

[out] RetFilter

指向调用方分配的变量的指针，该变量接收微型筛选器驱动程序的不透明筛选器指针，该驱动程序的名称与 FilterName 参数中的名称匹配。此参数是必需的，不能 NULL。

返回值

FltGetFilterFromName 返回STATUS_SUCCESS或相应的 NTSTATUS 值，例如以下值之一：

返回代码	描述
STATUS_FLT_DELETING_OBJECT	发现了一个匹配的微型筛选器驱动程序，但它正在被拆毁。这是一个错误代码。
STATUS_FLT_FILTER_NOT_FOUND	找不到匹配的微型筛选器驱动程序。这是一个错误代码。

言论

FltGetFilterFromName 添加对 RetFilter 参数中返回的不透明筛选器指针的运行引用。不再需要此指针时，调用方必须通过调用 FltObjectDereference释放它。因此，对 FltGetFilterFromName 的每个成功调用都必须匹配对 FltObjectDereference的后续调用。

若要向筛选器管理器注册微型筛选器驱动程序，请调用 FltRegisterFilter。