FltGetFilterFromInstance 函式 (fltkernel.h)

發行項
02/29/2024

FltGetFilterFromInstance 例程會傳回建立指定實例之迷你篩選驅動程式的不透明篩選指標。

語法

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

參數

[in] Instance

實例的不透明實例指標。

[out] RetFilter

呼叫端配置的變數指標，該變數會接收迷你篩選驅動程式的不透明篩選指標。這個參數是必要的，而且不能是 NULL。

傳回值

FltGetFilterFromInstance 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：

傳回碼	Description
STATUS_FLT_DELETING_OBJECT	迷你篩選驅動程式正在損毀。這是錯誤碼。

備註

FltGetFilterFromInstance 會將取消參考新增至 RetFilter 參數中傳回的不透明篩選指標。不再需要此指標時，呼叫端必須呼叫 FltObjectDereference 來釋放它。因此，每次成功呼叫 FltGetFilterFromInstance 時，都必須符合 後續對 FltObjectDereference 的呼叫。

若要取得附加指定迷你篩選驅動程序實例所在磁碟區的不透明磁碟區指標，請呼叫 FltGetVolumeFromInstance。

若要列舉指定迷你篩選驅動程式的所有實例，請呼叫 FltEnumerateInstanceInformationByFilter。

若要列舉所有磁碟區上所有迷你篩選驅動程序的實例，請呼叫 FltEnumerateInstances。