FltDeleteInstanceContext 函数（fltkernel.h）

FltDeleteInstanceContext 从给定实例中删除上下文，并标记要删除的上下文。

语法

NTSTATUS FLTAPI FltDeleteInstanceContext(
  [in]  PFLT_INSTANCE Instance,
  [out] PFLT_CONTEXT  *OldContext
);

[in] Instance

实例的不透明实例指针。

[out] OldContext

指向接收已删除上下文地址的调用方分配的变量的指针。此参数是可选的，可以 NULL。如果 OldContext 未 NULL 且不指向NULL_CONTEXT，则调用方负责调用 FltReleaseContext 在不再需要上下文时释放此上下文。

FltDeleteInstanceContext 返回STATUS_SUCCESS或适当的 NTSTATUS 值，例如以下值之一：

返回代码	描述
STATUS_FLT_DELETING_OBJECT	指定的实例正在被拆毁。这是一个错误代码。
STATUS_NOT_FOUND	找不到匹配的上下文。这是一个错误代码。

有关上下文的详细信息，请参阅关于小型筛选器上下文。

由于上下文是引用计数的，因此小型筛选器驱动程序通常不需要调用例程（如 FltDeleteInstanceContext）来显式删除上下文。

微型筛选器驱动程序调用 FltDeleteInstanceContext 从实例中删除上下文并标记要删除的上下文。上下文通常立即释放，除非有未完成的引用（例如，因为上下文仍在由另一个线程使用）。

若要分配新上下文，请调用 FltAllocateContext。

若要获取实例上下文，请调用 FltGetInstanceContext。

若要设置实例上下文，请调用 FltSetInstanceContext。