PFLT_CONTEXT_CLEANUP_CALLBACK コールバック関数 (fltkernel.h)

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

ミニフィルタードライバーは、ミニフィルタードライバーの ContextCleanupCallback ルーチンとしてPFLT_CONTEXT_CLEANUP_CALLBACK型のルーチンを登録できます。

構文

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

void PfltContextCleanupCallback(
  [in] PFLT_CONTEXT Context,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

パラメーター

[in] Context

コンテキストのミニフィルタードライバーの部分へのポインター。

[in] ContextType

コンテキストの種類。次のいずれかの値を指定する必要があります。

FLT_FILE_CONTEXT (Windows Vista 以降)

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

FLT_SECTION_CONTEXT (Windows 8 以降)

FLT_TRANSACTION_CONTEXT (Windows Vista 以降)

FLT_VOLUME_CONTEXT

戻り値

なし

解説

ミニフィルタードライバーは、必要に応じて、DriverEntry ルーチンから FltRegisterFilter を呼び出すときに登録するコンテキストの種類ごとに、ミニフィルタードライバーの ContextCleanupCallback ルーチンとしてPFLT_CONTEXT_CLEANUP_CALLBACK型のルーチンを指定できます。このルーチンを指定するために、ミニフィルタードライバーは、コンテキスト型のFLT_CONTEXT_REGISTRATION構造体の ContextCleanupCallback メンバーにルーチンへのポインターを格納します。

ミニフィルタードライバーがコンテキスト型の ContextCleanupCallback ルーチンを指定する場合、フィルターマネージャーは、その型のミニフィルタードライバーのコンテキストのいずれかを解放する前に、このルーチンを呼び出します。このルーチンでは、ミニフィルタードライバーは、コンテキスト構造内でミニフィルタードライバーが割り当てた追加のメモリを解放するなど、必要なクリーンアップを実行します。 ContextCleanupCallback ルーチンが戻った後、フィルターマネージャーはコンテキストを解放します。

コンテキスト登録の詳細については、 FLT_CONTEXT_REGISTRATIONのリファレンスエントリを参照してください。