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。

当每个上下文的引用计数达到零时,如果调用方在 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