FltDeleteInstanceContext 関数 (fltkernel.h)

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

FltDeleteInstanceContext は 、特定のインスタンスからコンテキストを削除し、コンテキストに削除のマークを付けます。

構文

NTSTATUS FLTAPI FltDeleteInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *OldContext
);

パラメーター

[in] Instance

インスタンスの不透明なインスタンスポインター。

[out] OldContext

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

戻り値

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

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

注釈

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

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

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

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

インスタンスコンテキストを取得するには、 FltGetInstanceContext を呼び出します。

インスタンスコンテキストを設定するには、 FltSetInstanceContext を呼び出します。