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 ，它被微过滤驱动释放。