FltReleaseContextsEx 函式 (fltkernel.h)

FltReleaseContextsEx 會釋放指定 FLT_RELATED_CONTEXTS_EX 結構中的每個內容。

語法

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

參數

[in] ContextsSize

Contexts 所指向之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執行。

當每個內容的參考計數達到零時,如果呼叫端在 IRQL <= APC_LEVEL上執行,就會立即釋放內容。 如果呼叫端在 IRQL DISPATCH_LEVEL執行,則會排程工作專案以釋放內容。

規格需求

需求
最低支援的用戶端 從 Windows 8 開始提供。
目標平台 Universal
標頭 fltkernel.h (包含 Fltkernel.h)
程式庫 FltMgr.lib
Dll Fltmgr.sys
IRQL 請參閱一節。

另請參閱

FLT_CONTEXT_REGISTRATION

FLT_RELATED_CONTEXTS_EX

FltAllocateContext

FltGetContextsEx

FltReleaseContext