FltUnloadFilter 函式 (fltkernel.h)

  • 發行項

已藉由呼叫 FltLoadFilter 載入支援的迷你篩選驅動程式的迷你篩選驅動程式，可以藉由呼叫 FltUnloadFilter 來卸除迷你篩選驅動程式。

語法

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

參數

[in] FilterName

UNICODE_STRING結構的指標，其中包含傳遞至 FltLoadFilter 的迷你篩選驅動程式服務名稱。

傳回值

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

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

備註

相依於另一個迷你篩選驅動程式的迷你篩選驅動程式可以藉由呼叫 FltUnloadFilter 來卸除該迷你篩選驅動程式。 此例程會搜尋已註冊的迷你篩選驅動程式，其服務名稱符合指定的 FilterName ，並呼叫 minifilter 驅動程式的 FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) 例程。

如果支援的迷你篩選驅動程式未註冊 FilterUnloadCallback 例程， 則 FltUnloadFilter 的呼叫會失敗。

迷你篩選驅動程式無法呼叫 FltUnloadFilter 以自行卸除。

規格需求

需求 值
目標平台 Universal
標頭 fltkernel.h (包含 Fltkernel.h)
程式庫 FltMgr.lib
Dll Fltmgr.sys
IRQL PASSIVE_LEVEL

另請參閱

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING