共用方式為

FltGetFilterFromName 函式 （fltkernel.h）

  • 發行項

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

語法

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

參數

[in] FilterName

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

[out] RetFilter

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

傳回值

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

傳回碼 描述
STATUS_FLT_DELETING_OBJECT
 找到相符的小型篩選驅動程式，但它正在被拆毀。 這是錯誤碼。
STATUS_FLT_FILTER_NOT_FOUND
 找不到相符的迷你篩選驅動程式。 這是錯誤碼。

言論

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

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

要求

要求 價值
目標平臺 普遍
標頭 fltkernel.h （包括 Fltkernel.h）
連結庫 FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另請參閱

FltObjectDereference

FltRegisterFilter

UNICODE_STRING