FltDeleteContext 関数 (fltkernel.h)

FltDeleteContext 、指定したコンテキストを削除対象としてマークします。

構文

VOID FLTAPI FltDeleteContext(
  [in] PFLT_CONTEXT Context
);

[in] Context

削除するコンテキストへのポインター。このパラメーターは必須であり、NULL することはできません。

何一つ。

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

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

FltDeleteContext 、コンテキストを削除対象としてマークします。コンテキストは、(たとえば、コンテキストがまだ別のスレッドによって使用されているため) 未処理の参照がない限り、そのコンテキストの現在の参照が解放されるとすぐに解放されます。

FltDeleteContext を使用する場合は、次考慮する必要があります。

ミニフィルタードライバーが FltDeleteContext 呼び出す場合、ミニフィルタードライバーにはコンテキストへの参照が既に必要です。ただし、ミニフィルタードライバーが FltDeleteStreamHandleContext 、fltDeleteStreamContext 、FltDeleteInstanceContextなどを呼び出す場合、ミニフィルタードライバーはコンテキストへの参照を必要としません。ミニフィルタードライバーが FltDeleteContext 呼び出した後、そのコンテキストへの参照は引き続き有効です。ミニフィルタードライバーは、FltReleaseContext ルーチンを呼び出して、コンテキストへの参照を解放する必要があります。
FltDeleteContext 、内部フィルターマネージャー構造からコンテキストを削除します。その後、FltGetContexts や FltGetInstanceContextなど、コンテキストを取得する関数をさらに呼び出しても、そのコンテキストを見つけることができません。ただし、コンテキストメモリは、コンテキストの参照カウントが 0 になるまで解放されません。

コンテキストは、次の表から適切な delete コンテキストルーチンを呼び出すことによって削除することもできます。

コンテキストの種類	Delete-Context ルーチン
FLT_FILE_CONTEXT	FltDeleteFileContext をします (Windows Vista 以降のみ)。
FLT_INSTANCE_CONTEXT	FltDeleteInstanceContext の
FLT_SECTION_CONTEXT	FltCloseSectionForDataScan をします (Windows 8 以降のみ)。
FLT_STREAM_CONTEXT	FltDeleteStreamContext の
FLT_STREAMHANDLE_CONTEXT	FltDeleteStreamHandleContext の
FLT_TRANSACTION_CONTEXT	FltDeleteTransactionContext をします (Windows Vista 以降のみ)。
FLT_VOLUME_CONTEXT	FltDeleteVolumeContext をする

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

コンテキストの参照カウントをインクリメントするには、FltReferenceContext 呼び出します。

コンテキストの参照カウントを減らすには、FltReleaseContext 呼び出します。

セクションコンテキストFLT_SECTION_CONTEXT型は、FltDeleteContext 使用して削除することはできません。代わりに、FltReleaseContext 使用してセクションコンテキストの割り当てを解除します。