FltCompareInstanceAltitudes 函式 (fltkernel.h)

FltCompareInstanceAltitudes 會比較兩個迷你篩選驅動程序實例的高度。

語法

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

[in] Instance1

第一個實例的指標。

[in] Instance2

第二個實例的指標。

FltCompareInstanceAltitudes 會傳回帶正負號的值，以提供比較的結果，如下所示：

傳回碼	Description
Zero	Instance1 會附加在與 Instance2 相同的高度。只有當 Instance1 和 Instance2 附加至不同的磁碟區，或者 Instance1 和 Instance2 是相同實例的指標時，才會發生此情況。
小於零	Instance1 的附加高度低於 Instance2。
大於零	Instance1 的附加高度高於 Instance2。

Instance1 和 Instance2 指向的迷你篩選驅動程式實例可以是相同迷你篩選驅動程式或不同迷你篩選驅動程式的實例。不過，如果 FltCompareInstanceAltitudes 傳回的結果有意義，則必須將它們附加至相同的磁碟區。

「高度」一詞是指實例佔用 (或應該佔用磁碟區迷你篩選驅動程序實例堆疊中) 的位置。高度愈高，實例就愈遠於堆疊中的基底文件系統。在指定磁碟區上的指定高度上，只能附加一個實例。

高度是由 高度字串所指定，這是由 0 到 9 之一或多個十進位數組成的計算 Unicode 字串;字串可以包含單一小數點。例如，“100.123456” 和 “03333” 是有效的高度字串。

字串串 “03333” 代表高於 “100.123456” (前置和尾端零的高度。) 換句話說，高度為 “03333” 的實例比高度為 “100.123456” 的實例遠。不過，只有在兩個實例都附加至相同的磁碟區時，此比較才有意義。

若要將迷你篩選驅動程序實例附加至磁碟區，請呼叫 FltAttachVolume 或 FltAttachVolumeAtAltitude。

若要從磁碟區中斷連結迷你篩選驅動程序實例，請呼叫 FltDetachVolume。