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 值,并且 InstanceIdNULL,FsRtlLookupPerStreamContext 返回 OwnerId 成员与 OwnerId 参数匹配的第一个每个流上下文。
返回值
没有
言论
文件系统筛选器驱动程序调用 FsRtlLookupPerStreamContext 来检索文件流的每个流上下文结构。 每个流上下文结构包含筛选器驱动程序为文件流维护的上下文信息。
若要将初始化的每个流上下文结构与文件流相关联,请调用 FsRtlInsertPerStreamContext。
若要删除与文件流关联的每个流上下文结构,请调用 FsRtlRemovePerStreamContext。
有关详细信息,请参阅旧文件系统筛选器驱动程序 中的跟踪 Per-Stream 上下文。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 SP4 更新汇总;Windows XP |
目标平台 | 桌面 |
标头 | ntifs.h (include Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
另请参阅
FsRtlGetPerStreamContextPointer