FilterLoad 関数 (fltuser.h)
FilterLoad 関数は、ミニフィルター ドライバーをシステムに動的に読み込みます。
構文
HRESULT FilterLoad(
[in] LPCWSTR lpFilterName
);
パラメーター
[in] lpFilterName
ミニフィルター ドライバーのサービス名を指定する null で終わるワイド文字文字列へのポインター。 このパラメーターは必須であり、 NULL または空の文字列にすることはできません。
戻り値
FilterLoad は、成功した場合S_OKを返します。 それ以外の場合は、次のいずれかのエラー値が返されます。
| リターン コード | 説明 |
|---|---|
|
ミニフィルター ドライバーは既に実行されています。 |
|
一致するミニフィルター ドライバーが見つかりませんでした。 |
|
ミニフィルター ドライバーは既に実行されています。 |
|
lpFilterName で指定されたミニフィルター ドライバーの読み込みイメージが無効です。 |
|
lpFilterName で指定されたミニフィルター ドライバーの読み込みイメージが無効です。 |
|
ミニフィルター ドライバーに無効なデジタル署名があります。 |
解説
FilterLoad は、 FltLoadFilter と同等の Win32 です。
カーネル モード ミニフィルター ドライバーに依存するユーザー モード アプリケーションは、 FilterLoad を呼び出すことによってミニフィルター ドライバーを読み込むことができます。
FilterLoad の呼び出し元は、ミニフィルター ドライバーを読み込むかアンロードするには、SeLoadDriverPrivilege (SE_LOAD_DRIVER_PRIVILEGE の LUID) を持っている必要があります。 この特権の名前は、SE_LOAD_DRIVER_NAME名定数によって指定されます。 (特権については、Windows 7 用 Microsoft Windows ソフトウェア開発キット (SDK) および .NET Framework 4.0 のドキュメントを参照してください)。
ミニフィルター ドライバーをアンロードするには、 FilterUnload を呼び出します。
要件
| 対象プラットフォーム | ユニバーサル |
| Header | fltuser.h (Fltuser.h を含む) |
| Library | FltLib.lib |
| [DLL] | FltLib.dll |