FilterInstanceCreate 関数 (fltuser.h)
FilterInstanceCreate 関数は、指定されたミニフィルター インスタンスとの通信に使用できるハンドルを作成します。
構文
HRESULT FilterInstanceCreate(
[in] LPCWSTR lpFilterName,
[in] LPCWSTR lpVolumeName,
[in, optional] LPCWSTR lpInstanceName,
[out] HFILTER_INSTANCE *hInstance
);
パラメーター
[in] lpFilterName
インスタンスを所有するミニフィルターの名前を含む null で終わるワイド文字列へのポインター。
[in] lpVolumeName
インスタンスがアタッチされているボリュームの名前を含む null で終わるワイド文字文字列へのポインター。
lpVolumeName 入力文字列には、次のいずれかを指定できます。 末尾の円記号 (\) は省略可能です。
- ドライブ文字 ("D:\" など)
- "c:\mnt\edrive\" などのボリューム マウント ポイントへのパス
- "\?" などの一意 のボリューム識別子 (ボリューム GUID 名とも呼ばれます)。\Volume{7603f260-142a-11d4-ac67-806d6172696f}\"
- "\Device\HarddiskVolume1\" などの非永続デバイス 名 (ターゲット名 または NT デバイス名とも呼ばれます)
[in, optional] lpInstanceName
インスタンスのインスタンス名を含む null で終わるワイド文字列へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。 NULL の場合、このボリュームでこのミニフィルターに対して見つかった最初のインスタンスが返されます。
[out] hInstance
FilterInstanceCreate の呼び出しが成功した場合にミニフィルター インスタンスの不透明なハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。それ以外の場合は、INVALID_HANDLE_VALUEを受け取ります。
戻り値
FilterInstanceCreate は、成功した場合S_OKを返します。 それ以外の場合は、エラー値を返します。
注釈
ユーザー モード アプリケーションは FilterInstanceCreate を呼び出して、カーネル モードミニフィルター インスタンスとの通信に使用できるハンドルを作成します。 返されるインスタンス ハンドルは、 FilterInstanceGetInformation などの関数にパラメーターとして渡すことができます。
FilterInstanceCreate によって返されるインスタンス ハンドルを閉じるには、FilterInstanceClose を呼び出します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | ユニバーサル |
| Header | fltuser.h (Fltuser.h を含む) |
| Library | FltLib.lib |
| [DLL] | FltLib.dll |