FltUnloadFilter 関数 (fltkernel.h)
FltLoadFilter を呼び出してサポート ミニフィルター ドライバーを読み込んだミニフィルター ドライバーは、FltUnloadFilter を呼び出すことによってミニフィルター ドライバーをアンロードできます。
構文
NTSTATUS FLTAPI FltUnloadFilter(
[in] PCUNICODE_STRING FilterName
);
パラメーター
[in] FilterName
FltLoadFilter に渡されたミニフィルター ドライバー サービス名を含むUNICODE_STRING構造体へのポインター。
戻り値
FltUnloadFilter は、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。
| リターン コード | 説明 |
|---|---|
|
一致するミニフィルター ドライバーが見つかりましたが、既に破棄されています。 これはエラー コードです。 |
|
一致するミニフィルター ドライバーが見つかりませんでした。 これはエラー コードです。 |
注釈
別のミニフィルター ドライバーに依存するミニフィルター ドライバーは、 FltUnloadFilter を呼び出すことによって、そのミニフィルター ドライバーをアンロードできます。 このルーチンは、指定された FilterName と一致するサービス名を持つ登録済みミニフィルター ドライバーを検索し、そのミニフィルター ドライバーの FilterUnloadCallback (PFLT_FILTER_UNLOAD_CALLBACK) ルーチンを呼び出します。
サポートするミニフィルター ドライバーが FilterUnloadCallback ルーチンを登録しなかった場合、 FltUnloadFilter の呼び出しは失敗します。
ミニフィルター ドライバーは、 FltUnloadFilter を呼び出してそれ自体をアンロードすることはできません。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | fltkernel.h (Fltkernel.h を含む) |
| Library | FltMgr.lib |
| [DLL] | Fltmgr.sys |
| IRQL | PASSIVE_LEVEL |