fltGetTransactionContext 函数 (fltkernel.h)

项目
08/07/2023

FltGetTransactionContext 例程检索由给定微筛选器驱动程序为事务设置的上下文。

语法

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

参数

[in] Instance

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

[in] Transaction

正在检索其上下文的事务的不透明事务指针。

[out] Context

指向调用方分配的变量的指针，该变量接收事务上下文的地址。

返回值

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

返回代码	说明
STATUS_NOT_FOUND	找不到匹配的上下文。这是错误代码。

注解

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

FltGetTransactionContext 递增 Context 参数指向的上下文的引用计数。当不再需要此上下文指针时，调用方必须通过调用 FltReleaseContext 来递减其引用计数。因此，每次成功调用 FltGetTransactionContext 都必须通过后续调用 FltReleaseContext 进行匹配。

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

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

若要删除事务上下文，请调用 FltDeleteTransactionContext 或 FltDeleteContext。