FsRtlLookupPerStreamContext 宏 (ntifs.h)

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

语法

void FsRtlLookupPerStreamContext(
   _sc,
   _oid,
   _iid
);

参数

_sc

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

_oid

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

_iid

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

如果 OwnerIdInstanceIdNULLFsRtlLookupPerStreamContext 返回找到的第一个每个流上下文。

如果为 OwnerId 提供非NULL 值,并且 InstanceIdNULLFsRtlLookupPerStreamContext 返回 OwnerId 成员与 OwnerId 参数匹配的第一个每个流上下文。

返回值

没有

言论

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

注释FsRtlLookupPerStreamContext 只能在支持每流上下文的文件系统上使用。
 
若要初始化每个流上下文结构,请使用 FsRtlInitPerStreamContext 宏。

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

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

有关详细信息,请参阅旧文件系统筛选器驱动程序 中的跟踪 Per-Stream 上下文。

要求

要求 价值
最低支持的客户端 Windows 2000 SP4 更新汇总;Windows XP
目标平台 桌面
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSetupAdvancedHeader

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts