FltCompareInstanceAltitudes 函数 (fltkernel.h)

FltCompareInstanceAltitudes 比较两个微筛选器驱动程序实例的高度。

语法

LONG FLTAPI FltCompareInstanceAltitudes(
  [in] PFLT_INSTANCE Instance1,
  [in] PFLT_INSTANCE Instance2
);

参数

[in] Instance1

指向第一个实例的指针。

[in] Instance2

指向第二个实例的指针。

返回值

FltCompareInstanceAltitudes 返回一个有符号值,该值提供比较结果,如下所示:

返回代码 说明
Zero
实例 1 附加到与 Instance2 相同的高度。 仅当 Instance1Instance2 附加到不同的卷,或者 Instance1Instance2 是指向同一实例的指针时,才会发生这种情况。
小于零
实例 1 附加在比 Instance2 低的高度。
大于零
实例 1 附加在比 Instance2 更高的高度。

注解

Instance1Instance2 指向的微筛选器驱动程序实例可以是同一微筛选器驱动程序或不同微筛选器驱动程序的实例。 但是,如果 FltCompareInstanceAltitudes 返回的结果有意义,则必须将其附加到同一卷。

术语“海拔”是指实例 (或应在卷的微筛选器驱动程序实例堆栈中占据) 的位置。 高度越高,实例离堆栈中基本文件系统的距离就越远。 在给定卷的给定高度上只能附加一个实例。

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

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

若要将微筛选器驱动程序实例附加到卷,请调用 FltAttachVolumeFltAttachVolumeAtAltitude

若要从卷中分离微筛选器驱动程序实例,请调用 FltDetachVolume

要求

要求
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FltAttachVolume

FltAttachVolumeAtAltitude

FltCompareInstanceAltitudes

FltDetachVolume