FltGetFilterFromInstance 函数 (fltkernel.h)

项目
02/26/2024

FltGetFilterFromInstance 例程返回创建给定实例的微筛选器驱动程序的不透明筛选器指针。

语法

NTSTATUS FLTAPI FltGetFilterFromInstance(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_FILTER   *RetFilter
);

参数

[in] Instance

实例的不透明实例指针。

[out] RetFilter

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

返回值

FltGetFilterFromInstance 返回STATUS_SUCCESS或相应的 NTSTATUS 值，如下所示：

返回代码	说明
STATUS_FLT_DELETING_OBJECT	微筛选器驱动程序正在被拆毁。这是错误代码。

注解

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

若要获取给定微筛选器驱动程序实例所附加到的卷的不透明卷指针，请调用 FltGetVolumeFromInstance。

若要枚举给定微筛选器驱动程序的所有实例，请调用 FltEnumerateInstanceInformationByFilter。

若要枚举所有卷上所有微筛选器驱动程序的实例，请调用 FltEnumerateInstances。