FsRtlLookupPerStreamContext 宏 (ntifs.h)

FsRtlLookupPerStreamContext 宏检索文件流的每流上下文结构。

语法

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

_sc

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

_oid

指向调用方分配的变量的指针，该变量唯一标识每流上下文结构的所有者。此变量的格式是特定于筛选器驱动程序。 如果为InstanceId 提供非 NULL 值，则必须为非 NULL。

_iid

指向筛选器驱动程序的指针，分配的变量可用于区分由同一筛选器驱动程序创建的按流上下文结构。此变量的格式是特定于筛选器驱动程序。

如果 OwnerId 和 InstanceId 均为 NULL，FsRtlLookupPerStreamContext 将返回找到的第一个每个流上下文。

如果为 OwnerId 提供了非 NULL 值，而 InstanceId 为 NULL，FsRtlLookupPerStreamContext 将返回找到其 OwnerId 成员与 OwnerId 参数匹配的第一个每流上下文。

无

文件系统筛选器驱动程序调用 FsRtlLookupPerStreamContext 来检索文件流的每流上下文结构。每流上下文结构包含筛选器驱动程序为文件流维护的上下文信息。

注意FsRtlLookupPerStreamContext 只能在支持每流上下文的文件系统上使用。

若要初始化每流上下文结构，请使用 FsRtlInitPerStreamContext 宏。

若要将初始化的每流上下文结构与文件流相关联，请调用 FsRtlInsertPerStreamContext。

若要删除与文件流关联的每流上下文结构，请调用 FsRtlRemovePerStreamContext。