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开始可用。 |
目标平台 | 通用 |
标头 | fltkernel.h (包括 Fltkernel.h) |
Library | FltMgr.lib |
DLL | Fltmgr.sys |
IRQL | 请参见“备注”部分。 |