FltAttachVolume 関数 (fltkernel.h)

[アーティクル]
08/07/2023

FltAttachVolume は、新しいミニフィルタードライバーインスタンスを作成し、指定されたボリュームにアタッチします。

構文

NTSTATUS FLTAPI FltAttachVolume(
  [in, out]      PFLT_FILTER      Filter,
  [in, out]      PFLT_VOLUME      Volume,
  [in, optional] PCUNICODE_STRING InstanceName,
  [out]          PFLT_INSTANCE    *RetInstance
);

パラメーター

[in, out] Filter

呼び出し元の不透明なフィルターポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in, out] Volume

ミニフィルタードライバーインスタンスがアタッチされるボリュームの不透明なボリュームポインター。このパラメーターは必須であり、 NULL にすることはできません。

[in, optional] InstanceName

新しいインスタンスのインスタンス名を含む UNICODE_STRING 構造体へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。 NULL の場合、FltAttachVolume はミニフィルタードライバーの既定のインスタンス名をレジストリから読み取ろうとします。 (このパラメーターの詳細については、次の「解説」セクションを参照してください)。

[out] RetInstance

新しく作成されたインスタンスの不透明なインスタンスポインターを受け取る呼び出し元によって割り当てられた変数へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。

戻り値

FltAttachVolume は、次のいずれかのSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。

リターンコード	説明
STATUS_FLT_DELETING_OBJECT	指定したフィルターまたはボリュームが破棄されています。これはエラーコードです。
STATUS_FLT_FILTER_NOT_READY	ミニフィルタードライバーがフィルター処理を開始していません。詳細については、「 FltStartFiltering」を参照してください。これはエラーコードです。
STATUS_FLT_INSTANCE_NAME_COLLISION	指定されたボリュームに、この名前のインスタンスが既に存在します。
STATUS_INSUFFICIENT_RESOURCES	FltAttachVolume でプール割り当てエラーが発生しました。これはエラーコードです。
STATUS_OBJECT_NAME_COLLISION	レジストリから読み取られたインスタンス属性で指定された高度で、別のインスタンスが既にアタッチされています。これはエラーコードです。

注釈

呼び出し元が InstanceName に NULL 以外の値を指定した場合、FltAttachVolume は、レジストリに格納されているミニフィルタードライバーで指定されたインスタンス属性を HKLM\CurrentControlSet\Services\ServiceName\Instances\InstanceName の下で読み取ります。ここで、ServiceName はミニフィルタードライバーのサービス名です。このサービス名は、ミニフィルタードライバーの INF ファイルの DefaultInstall.Services セクションの AddService ディレクティブで指定されます。 (フィルタードライバー INF ファイルの詳細については、「ファイルシステムフィルタードライバーのインストール」を参照してください)。

呼び出し元が InstanceName の値を指定しない場合、FltAttachVolume は、レジストリパスの InstanceName 部分に HKLM\CurrentControlSet\Services\ServiceName\Instances\DefaultInstance の下のレジストリに格納されている名前を使用します。

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

FltAttachVolume は 、*RetInstance 内の新しいインスタンスの不透明なインスタンスポインターを返します。このポインター値は、ミニフィルタードライバーインスタンスを一意に識別し、インスタンスがボリュームにアタッチされている限り一定のままになります。

FltAttachVolume は、 *RetInstance で返される不透明なインスタンスポインターにランダウン参照を追加します。このポインターが不要になった場合、呼び出し元は FltObjectDereference を呼び出して解放する必要があります。したがって、 FltAttachVolume への正常な呼び出しはすべて、 FltObjectDereference の後続の呼び出しと一致する必要があります。

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

同じボリュームにアタッチされている 2 つのミニフィルタードライバーインスタンスの高度を比較するには、 FltCompareInstanceAltitudes を呼び出します。

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