FltDeleteStreamHandleContext 関数 (fltkernel.h)

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

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

構文

NTSTATUS FLTAPI FltDeleteStreamHandleContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *OldContext
);

パラメーター

[in] Instance

ストリームハンドルにアタッチされているコンテキストの一覧からコンテキストを削除するミニフィルタードライバーインスタンスの不透明なインスタンスポインター。

[in] FileObject

ファイルストリームのファイルオブジェクトへのポインター。

[out] OldContext

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

戻り値

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

リターンコード	説明
STATUS_FLT_DELETING_OBJECT	指定したインスタンスが破棄されています。これはエラーコードです。
STATUS_NOT_FOUND	一致するコンテキストが見つかりませんでした。これはエラーコードです。
STATUS_NOT_SUPPORTED	ファイルシステムでは、このファイルストリームハンドルのストリームごとのコンテキストはサポートされていません。これはエラーコードです。

注釈

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

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

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

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

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

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

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	<= APC_LEVEL