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