FltGetUpperInstance 函式 (fltkernel.h)

發行項
03/05/2024

FltGetUpperInstance 例程會傳回下一個較高迷你篩選驅動程序實例的不透明實例指標，如果有一個附加在相同磁碟區上指定迷你篩選驅動程序實例上方。

語法

NTSTATUS FLTAPI FltGetUpperInstance(
  [in]  PFLT_INSTANCE CurrentInstance,
  [out] PFLT_INSTANCE *UpperInstance
);

參數

[in] CurrentInstance

要求下一個較高實例之實例的不透明實例指標。

[out] UpperInstance

呼叫端配置的變數指標，該變數會接收下一個較高實例的不透明實例指標。這個參數是必要的，而且不能是 NULL。

傳回值

FltGetUpperInstance 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如：

傳回碼	Description
STATUS_NO_MORE_ENTRIES	找不到較高的實例。這是警告碼。

備註

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

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

字串 “033333” 代表高於 “100.123456” 的高度。 (開頭和尾端零會被忽略。) 換句話說，高度為 “03333” 的實例比高度為 “100.123456” 的實例遠於基底文件系統。不過，只有在兩個實例都附加至相同的磁碟區時，此比較才有意義。

FltGetUpperInstance 會在 UpperInstance 參數中傳回的不透明實例指標中新增取消參考。不再需要此指標時，呼叫端必須呼叫 FltObjectDereference 來釋放它。因此，對 FltGetUpperInstance 的每個成功呼叫都必須與 後續對 FltObjectDereference 的呼叫相符。