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 | 请参阅“备注”部分。 |