FltGetStreamContext 函数（fltkernel.h）

项目
02/06/2025

FltGetStreamContext 例程检索由给定的微型筛选器驱动程序实例为文件流设置的上下文。

语法

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

参数

[in] Instance

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

[in] FileObject

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

[out] Context

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

返回值

FltGetStreamContext 成功返回请求的上下文时返回STATUS_SUCCESS。否则，它将返回适当的 NTSTATUS 值，例如以下值之一：

返回代码	描述
STATUS_NOT_FOUND	此时在此文件中找不到匹配的上下文，因此 FltMgr 将上下文设置为NULL_CONTEXT。这是一个错误代码。
STATUS_NOT_SUPPORTED	文件系统不支持此文件流的按流上下文。这是一个错误代码。

言论

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

FltGetStreamContext 检索由给定微型筛选器驱动程序实例为文件流设置的上下文。

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

若要设置文件流的上下文，请调用 FltSetStreamContext。

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

若要删除流上下文，请调用 FltDeleteStreamContext 或 FltDeleteContext。