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 值之一:
返回代码 | 描述 |
---|---|
|
成功调用 FsRtlInsertPerStreamContext。 |
|
基础文件系统不支持筛选器上下文。 |
言论
文件系统筛选器驱动程序调用 FsRtlInsertPerStreamContext,将自己的每流上下文结构与文件流相关联。 每个流上下文结构包含筛选器驱动程序为文件流维护的上下文信息。
将每个流上下文结构与文件流关联后,可以通过调用 FsRtlLookupPerStreamContext 或调用 FsRtlRemovePerStreamContext来检索它。
有关详细信息,请参阅旧文件系统筛选器驱动程序中的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 2000 SP4 更新汇总;Windows XP |
目标平台 | 普遍 |
标头 | ntifs.h (include Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <= APC_LEVEL |
另请参阅
FsRtlGetPerStreamContextPointer