次の方法で共有


FltReleaseContextsEx 関数 (fltkernel.h)

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

構文

VOID FLTAPI FltReleaseContextsEx(
  [in] SIZE_T                   ContextsSize,
  [in] PFLT_RELATED_CONTEXTS_EX Contexts
);

パラメーター

[in] ContextsSize

コンテキストが指す FLT_RELATED_CONTEXTS_EX 構造体のサイズ (バイト単位)。 sizeof(FLT_RELATED_CONTEXTS_EX) に設定します。

[in] Contexts

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

戻り値

何一つ

備考

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

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

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

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

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows 8 以降で使用できます。
ターゲット プラットフォーム 万国
ヘッダー fltkernel.h (Fltkernel.h を含む)
ライブラリ FltMgr.lib
DLL Fltmgr.sys
IRQL 「解説」セクションを参照してください。

関連項目

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext