FltReleaseContexts 関数 (fltkernel.h)

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

FltReleaseContexts は、 特定の FLT_RELATED_CONTEXTS 構造体内の各コンテキストを解放します。

構文

VOID FLTAPI FltReleaseContexts(
  [in] PFLT_RELATED_CONTEXTS Contexts
);

パラメーター

[in] Contexts

FLT_RELATED_CONTEXTS構造体へのポインター。

戻り値

なし

解説

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

FltReleaseContexts は 、 FLT_RELATED_CONTEXTS 構造体内のすべてのコンテキストに対して参照カウントをデクリメントし、構造体のすべてのメンバーをNULL_CONTEXTに設定します。

特定の I/O 要求の特定のミニフィルタードライバーの FLT_RELATED_CONTEXTS 構造を取得するには、 FltGetContexts を呼び出します。

コンテキスト参照カウントの詳細については、「コンテキストの参照」を参照してください。

すべてのコンテキストが非ページプールから割り当てられている場合、 FltReleaseContexts の呼び出し元は IRQL <= DISPATCH_LEVELで実行されている必要があります。ページプールからコンテキストが割り当てられた場合、呼び出し元は IRQL <= APC_LEVELで実行されている必要があります。

各コンテキストの参照カウントが 0 に達すると、呼び出し元が IRQL <= APC_LEVELで実行されている場合、コンテキストはすぐに解放されます。呼び出し元が IRQL DISPATCH_LEVELで実行されている場合、作業項目はコンテキストを解放するようにスケジュールされます。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	fltkernel.h (Fltkernel.h を含む)
Library	FltMgr.lib
[DLL]	Fltmgr.sys
IRQL	「解説」を参照してください。