FltGetLowerInstance 函数（fltkernel.h）

项目
02/06/2025

FltGetLowerInstance 例程返回下一个下一个小型筛选器驱动程序实例的不透明实例指针（如果有）附加到同一卷上的给定微型筛选器驱动程序实例下方。

语法

NTSTATUS FLTAPI FltGetLowerInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *LowerInstance
);

参数

[in] CurrentInstance

请求低微筛选器驱动程序实例的微型筛选器驱动程序实例的不透明实例指针。

[out] LowerInstance

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

返回值

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

返回代码	描述
STATUS_NO_MORE_ENTRIES	找不到较低的微型筛选器驱动程序实例。这是一个警告代码。

言论

一个实例据说低于另一个实例，如果它附加到同一卷的较低高度。术语“海拔”是指实例在卷的微型筛选器驱动程序实例堆栈中占据（或应占用）的位置。高度越高，实例离堆栈中基本文件系统越远。给定卷上的给定高度只能附加一个实例。

海拔高度由 高度字符串指定，该字符串由 0 到 9 之间的一个或多个十进制数字组成的计数 Unicode 字符串，它可以包含单个小数点。例如，“100.123456”和“03333”是有效的高度字符串。

字符串“03333”表示高度高于“100.123456”。（将忽略前导和尾随零。换句话说，其高度为“03333”的实例比高度为“100.123456”的实例远于基本文件系统。但是，仅当这两个实例都附加到同一卷时，此比较才有意义。

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