FltGetSectionContext 函数 (fltkernel.h)

  • 项目

FltGetSectionContext 例程检索由指定的微筛选器驱动程序实例为文件流创建的节上下文。

语法

NTSTATUS FLTAPI FltGetSectionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PFILE_OBJECT  FileObject,
  [out] PFLT_CONTEXT  *Context
);

参数

[in] Instance

要检索其上下文的微筛选器驱动程序实例的不透明实例指针。

[in] FileObject

指向流的文件对象的指针。

[out] Context

指向调用方分配的变量的指针，该变量接收上下文的地址。 此参数是必需的，不能设置为 NULL。

返回值

FltGetSectionContext 在成功返回请求的节上下文时返回STATUS_SUCCESS。 否则，它将返回相应的 NTSTATUS 值，例如以下值之一：

返回代码 说明
STATUS_NOT_FOUND 此时此文件上找不到匹配的上下文，因此 FltMgr 将 Context 设置为 NULL_CONTEXT。 这是错误代码。
STATUS_NOT_SUPPORTED 附加到此实例的卷不支持节上下文。 这是错误代码。

注解

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

FltGetSectionContext 检索由指定的微筛选器驱动程序实例为文件流创建的节上下文。 通过调用 FltCreateSectionForDataScan 创建节上下文。

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

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

微筛选器不得显式删除传递给 FltCreateSectionForDataScan 的节上下文。 在这种情况下，通过调用 FltCloseSectionForDataScan ，将解除分配节上下文并将其从流中删除。

要求

要求 值
最低受支持的客户端 Windows 8
目标平台 通用
标头 fltkernel.h (包括 Fltkernel.h)
Library FltMgr.lib
DLL Fltmgr.sys
IRQL <= APC_LEVEL

另请参阅

FltAllocateContext

FltCloseSectionForDataScan

FltCreateSectionForDataScan

FltReleaseContext