FltUnloadFilter 関数 (fltkernel.h)

  • [アーティクル]

FltLoadFilter を呼び出してサポート ミニフィルター ドライバーを読み込んだミニフィルター ドライバーは、FltUnloadFilter を呼び出すことによってミニフィルター ドライバーをアンロードできます。

構文

NTSTATUS FLTAPI FltUnloadFilter(
  [in] PCUNICODE_STRING FilterName
);

パラメーター

[in] FilterName

FltLoadFilter に渡されたミニフィルター ドライバー サービス名を含むUNICODE_STRING構造体へのポインター。

戻り値

FltUnloadFilter は、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターン コード 説明
STATUS_FLT_DELETING_OBJECT
 一致するミニフィルター ドライバーが見つかりましたが、既に破棄されています。 これはエラー コードです。
STATUS_FLT_FILTER_NOT_FOUND
 一致するミニフィルター ドライバーが見つかりませんでした。 これはエラー コードです。

注釈

別のミニフィルター ドライバーに依存するミニフィルター ドライバーは、 FltUnloadFilter を呼び出すことによって、そのミニフィルター ドライバーをアンロードできます。 このルーチンは、指定された FilterName と一致するサービス名を持つ登録済みミニフィルター ドライバーを検索し、そのミニフィルター ドライバーの FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) ルーチンを呼び出します。

サポートするミニフィルター ドライバーが FilterUnloadCallback ルーチンを登録しなかった場合、 FltUnloadFilter の呼び出しは失敗します。

ミニフィルター ドライバーは、 FltUnloadFilter を呼び出してそれ自体をアンロードすることはできません。

要件

要件 値
対象プラットフォーム ユニバーサル
Header fltkernel.h (Fltkernel.h を含む)
Library FltMgr.lib
[DLL] Fltmgr.sys
IRQL PASSIVE_LEVEL

こちらもご覧ください

FltLoadFilter

PFLT_FILTER_UNLOAD_CALLBACK

UNICODE_STRING