PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK コールバック関数 (fltkernel.h)

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

ミニフィルタードライバーは、ミニフィルタードライバーの InstanceQueryTeardownCallback ルーチンとしてPFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK型のルーチンを登録できます。

構文

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK PfltInstanceQueryTeardownCallback;

NTSTATUS PfltInstanceQueryTeardownCallback(
  [in] PCFLT_RELATED_OBJECTS FltObjects,
  [in] FLT_INSTANCE_QUERY_TEARDOWN_FLAGS Flags
)
{...}

パラメーター

[in] FltObjects

現在の操作に関連するオブジェクトの不透明なポインターを含むFLT_RELATED_OBJECTS構造体へのポインター。

[in] Flags

特定のインスタンスクエリティアダウンコールバックルーチンが呼び出された理由を記述するフラグのビットマスク。フラグは現在定義されていません。

戻り値

このコールバックルーチンは 、次のいずれかのSTATUS_SUCCESS または NTSTATUS 値を返します。

リターンコード	説明
STATUS_FLT_DO_NOT_DETACH	この状態値を返すことで、ミニフィルタードライバーインスタンスがデタッチされなくなります。これはエラーコードです。

注釈

ミニフィルタードライバーは、DriverEntry ルーチンから FltRegisterFilter を呼び出して自身を登録すると、ミニフィルタードライバーの InstanceQueryTeardownCallback ルーチンとしてPFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK型のルーチンを登録できます。

InstanceQueryTeardownCallback ルーチンを登録するために、ミニフィルタードライバーは、fltRegisterFilter の Registration パラメーターとして渡されるFLT_REGISTRATION構造体の InstanceQueryTeardownCallback メンバーにPFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK型のルーチンのアドレスを格納します。

フィルターマネージャーはこのルーチンを呼び出して、ミニフィルタードライバーが手動デタッチ要求に応答できるようにします。このような要求は、ユーザーモードアプリケーションが FilterDetach を呼び出すか、カーネルモードコンポーネントが FltDetachVolume を呼び出したときに受信されます。

ミニフィルタードライバーがアンロードされた場合やボリュームがマウント解除された場合など、自動または必須のデタッチ要求では、このルーチンは呼び出されません。

このルーチンがエラーまたは警告 NTSTATUS コード ( STATUS_FLT_DO_NOT_DETACH など) を返す場合、ミニフィルタードライバーインスタンスはボリュームからデタッチされません。それ以外の場合、インスタンスはデタッチされます。

ミニフィルタードライバーで InstanceQueryTeardownCallback ルーチンが定義されていない場合、FilterDetach または FltDetachVolume を呼び出してインスタンスを手動でデタッチすることはできません。