FltGetFilterFromName 函式 (fltkernel.h)

發行項
02/26/2024

FltGetFilterFromName 例程會傳回已註冊迷你篩選驅動程式的不透明篩選指標，其名稱符合 FilterName 參數中的值。

語法

NTSTATUS FLTAPI FltGetFilterFromName(
  [in]  PCUNICODE_STRING FilterName,
  [out] PFLT_FILTER      *RetFilter
);

參數

[in] FilterName

包含迷你篩選驅動程式名稱之UNICODE_STRING 結構的指標。 (名稱比較不區分大小寫。)

[out] RetFilter

呼叫端配置變數的指標，該變數會接收Minifilter驅動程式的不透明篩選指標，其名稱符合 FilterName 參數中的名稱。這個參數是必要的，而且不能是 NULL。

傳回值

FltGetFilterFromName 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	Description
STATUS_FLT_DELETING_OBJECT	找到相符的迷你篩選驅動程式，但正在損毀。這是錯誤碼。
STATUS_FLT_FILTER_NOT_FOUND	找不到相符的迷你篩選驅動程式。這是錯誤碼。

備註

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

若要向篩選管理員註冊迷你篩選驅動程式，請呼叫 FltRegisterFilter。