Releasing Contexts 释放上下文
微过滤驱动释放上下文通过调用。每次成功调用下面例程最终都要调用和它们对应的FltReleaseContext:
FltAllocateContext
FltGetXxxContext
FltReferenceContext
注意FltSetXxxContext返回的旧的上下文指针和FltDeleteContext返回的上下文指针必须被释放当他们不再需要
如下面的例子:
status = FltAllocateContext(
FltObjects->Filter, //驱动
FLT_INSTANCE_CONTEXT, //上下文类型
CTX_INSTANCE_CONTEXT_SIZE, //上下文大小
NonPagedPool, //池子类型
&instanceContext); //返回的上下文
...
status = FltSetInstanceContext(
FltObjects->Instance, //对象实例
FLT_SET_CONTEXT_KEEP_IF_EXISTS, //操作
instanceContext, //新的上下文
NULL); //旧的上下文
if (instanceContext != NULL) {
FltReleaseContext(instanceContext);
}
return status;
注意FltReleaseContext被调用不论调用FltSetInstanceContext是否成功。不论成功与否,调用者必须调用释放FltAllocateContext引用。
如果上下文设置实例成功,FltSetInstanceContext添加自己的引用给实例上下文。因此,被FltAllocateContext设置的引用不再需要,我们要调用FltReleaseContext移除它。
如果失败,上下文仅有一个引用,被 FltAllocateContext设置。当FltReleaseContext返回,实例上下文引用数为0 ,它被微过滤驱动释放。