FsRtlInsertPerStreamContext 函数 (ntifs.h)

FsRtlInsertPerStreamContext 例程将文件系统筛选器驱动程序的每流上下文结构与文件流相关联。

语法

NTSTATUS FsRtlInsertPerStreamContext(
       PFSRTL_ADVANCED_FCB_HEADER PerStreamContext,
  [in] PFSRTL_PER_STREAM_CONTEXT  Ptr
);

PerStreamContext

指向文件流的FSRTL_ADVANCED_FCB_HEADER结构的指针。若要从文件对象获取此指针，请使用 FsRtlGetPerStreamContextPointer 宏。

[in] Ptr

指向筛选器驱动程序已分配和初始化的FSRTL_PER_STREAM_CONTEXT结构的指针。若要初始化此结构，请使用 FsRtlInitPerStreamContext 宏。

FsRtlInsertPerStreamContext 返回以下 NTSTATUS 值之一：

返回代码	说明
STATUS_SUCCESS	已成功调用 FsRtlInsertPerStreamContext 。
STATUS_INVALID_DEVICE_REQUEST	基础文件系统不支持筛选器上下文。

文件系统筛选器驱动程序调用 FsRtlInsertPerStreamContext ，以将其自己的每流上下文结构与文件流相关联。每流上下文结构包含筛选器驱动程序为文件流维护的上下文信息。

将每流上下文结构与文件流关联后，可以通过调用 FsRtlLookupPerStreamContext 来检索它，或通过调用 FsRtlRemovePerStreamContext 将其删除。