FilterAttach 関数 (fltuser.h)

FilterAttach 関数は、指定されたボリュームに新しいミニフィルター インスタンスをアタッチします。

構文

HRESULT FilterAttach(
  [in]            LPCWSTR lpFilterName,
  [in]            LPCWSTR lpVolumeName,
  [in, optional]  LPCWSTR lpInstanceName,
  [in, optional]  DWORD   dwCreatedInstanceNameLength,
  [out, optional] LPWSTR  lpCreatedInstanceName
);

パラメーター

[in] lpFilterName

インスタンスを作成するミニフィルターの名前を含む null で終わるワイド文字列へのポインター。 このパラメーターは必須であり、 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 の場合、 FltAttachVolume の「解説」セクションで説明されているように、新しいインスタンスはミニフィルターの既定のインスタンス名を受け取ります。

[in, optional] dwCreatedInstanceNameLength

lpCreatedInstanceName が指すバッファーの長さ (バイト単位)。 このパラメーターは省略可能であり、0 にすることができます。

[out, optional] lpCreatedInstanceName

インスタンスがボリュームに正常にアタッチされた場合に、新しいインスタンスのインスタンス名を受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができます。 NULL でない場合、バッファーは、INSTANCE_NAME_MAX_CHARS文字と NULL ターミネータを保持するのに十分な大きさにする必要があります。

戻り値

成功した場合、FilterAttach はS_OKを返します。 それ以外の場合は、次のいずれかのエラー値を返します。

注釈

FilterAttach は、 FltAttachVolume に相当する Win32 です。

lpInstanceName で指定されたインスタンス名は、システム全体で一意である必要があります。

特定の高度のボリュームにミニフィルター インスタンスをアタッチするには、 FilterAttachAtAltitude を呼び出します。

ミニフィルター インスタンスをボリュームからデタッチするには、 FilterDetach を呼び出します。

要件

こちらもご覧ください

FilterAttachAtAltitude

FilterDetach

FltAttachVolume