FltDeleteVolumeContext 関数 (fltkernel.h)

[アーティクル]
02/26/2024

FltDeleteVolumeContext は、特定のミニフィルタードライバーが特定のボリュームに対して設定したコンテキストを削除し、コンテキストに削除のマークを付けます。

構文

NTSTATUS FLTAPI FltDeleteVolumeContext(
  [in]            PFLT_FILTER  Filter,
  [in]            PFLT_VOLUME  Volume,
  [out, optional] PFLT_CONTEXT *OldContext
);

パラメーター

[in] Filter

呼び出し元の不透明なフィルターポインター。

[in] Volume

ボリュームの不透明なボリュームポインター。

[out, optional] OldContext

削除されたコンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。このパラメーターは省略可能であり、 NULL にすることができます。 OldContext が NULL ではなく、NULL_CONTEXTを指していない場合、呼び出し元は FltReleaseContext を呼び出して、不要になったときにこのコンテキストを解放します。

戻り値

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

リターンコード	説明
STATUS_FLT_DELETING_OBJECT	指定したボリュームが破棄されています。これはエラーコードです。
STATUS_NOT_FOUND	一致するコンテキストが見つかりませんでした。これはエラーコードです。

注釈

コンテキストの詳細については、「ミニフィルターコンテキストについて」を参照してください。

コンテキストは参照カウントされるため、通常、ミニフィルタードライバーが FltDeleteVolumeContext などのルーチンを呼び出してコンテキストを明示的に削除する必要はありません。

ミニフィルタードライバーは 、FltDeleteVolumeContext を呼び出して、ボリュームからコンテキストを削除し、コンテキストに削除のマークを付けます。コンテキストは通常、未処理の参照がない限りすぐに解放されます (たとえば、コンテキストが別のスレッドでまだ使用されているため)。

新しいコンテキストを割り当てるには、 FltAllocateContext を呼び出します。

ボリュームコンテキストを取得するには、 FltGetVolumeContext を呼び出します。

ボリュームコンテキストを設定するには、 FltSetVolumeContext を呼び出します。