次の方法で共有


FltDeleteStreamHandleContext 関数 (fltkernel.h)

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

構文

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

パラメーター

[in] Instance

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

[in] FileObject

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

[out] OldContext

削除されたコンテキストのアドレスを受け取る呼び出し元によって割り当てられた変数へのポインター。 このパラメーターは省略可能であり、 NULL にすることができますOldContextNULL ではなく、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

こちらもご覧ください

FltAllocateContext

FltDeleteContext

FltGetStreamHandleContext

FltReleaseContext

FltSetStreamHandleContext