FilterCreate 関数 (fltuser.h)

FilterCreate 関数は、指定されたミニフィルターのハンドルを作成します。

構文

HRESULT FilterCreate(
  [in]  LPCWSTR lpFilterName,
  [out] HFILTER *hFilter
);

[in] lpFilterName

ミニフィルターの名前を含む null で終わるワイド文字列へのポインター。このパラメーターは必須であり、 NULL にすることはできません。

[out] hFilter

FilterCreate の呼び出しが成功した場合にミニフィルターのハンドルを受け取る呼び出し元によって割り当てられた変数へのポインター。それ以外の場合は、INVALID_HANDLE_VALUEを受け取ります。

FilterCreate は、成功した場合S_OKを返します。それ以外の場合は、エラー値を返します。

ユーザーモードアプリケーションは FilterCreate を 呼び出して、カーネルモードミニフィルターとの通信に使用できるハンドルを作成します。返されたミニフィルターハンドルは、 FilterGetInformation などの関数にパラメーターとして渡すことができます。

FilterCreate によって返されるフィルターハンドルを閉じるには、FilterClose を呼び出します。