fltDeleteTransactionContext 函数 (fltkernel.h)

项目
02/27/2024

FltDeleteTransactionContext 例程从给定事务中删除上下文，并标记要删除的上下文。

语法

NTSTATUS FLTAPI FltDeleteTransactionContext(
  [in]            PFLT_INSTANCE Instance,
  [in]            PKTRANSACTION Transaction,
  [out, optional] PFLT_CONTEXT  *OldContext
);

参数

[in] Instance

调用方不透明的实例指针。

[in] Transaction

要删除其上下文的事务的不透明事务指针。

[out, optional] OldContext

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

返回值

FltDeleteTransactionContext 返回STATUS_SUCCESS或相应的 NTSTATUS 值，如下所示：

返回代码	说明
STATUS_FLT_DELETING_OBJECT	指定的实例正在被拆掉。这是错误代码。
STATUS_NOT_FOUND	找不到匹配的上下文。这是错误代码。

注解

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

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

微筛选器驱动程序调用 FltDeleteTransactionContext 以从事务中删除上下文并标记要删除的上下文。上下文通常立即释放，除非 (存在未完成的引用，因为该上下文仍被另一个线程) 使用。

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

若要检索事务上下文，请调用 FltGetTransactionContext。

若要设置事务上下文，请调用 FltSetTransactionContext。

要求

要求	值
最低受支持的客户端	Windows Vista 及更高版本
目标平台	通用
标头	fltkernel.h (包括 Fltkernel.h)
Library	FltMgr.lib
IRQL	<= APC_LEVEL