FsRtlGetPerStreamContextPointer 宏 (ntifs.h)

项目
02/29/2024

FsRtlGetPerStreamContextPointer 宏返回文件流的文件系统流上下文。

语法

void FsRtlGetPerStreamContextPointer(
   _fo
);

参数

_fo

指向文件流的文件对象的指针。

返回值

无

备注

文件系统筛选器驱动程序可以使用 FsRtlGetPerStreamContextPointer 宏获取由给定文件对象表示的文件流的流上下文指针。流上下文指针是指向文件系统的文件流的流上下文的指针。此指针可以作为参数传递给 FsRtlInsertPerStreamContext、 FsRtlLookupPerStreamContext 和 FsRtlRemovePerStreamContext。

流上下文指针指向唯一标识文件系统的文件流的 FSRTL_ADVANCED_FCB_HEADER 结构。此结构通常嵌入到流上下文对象中，例如文件控制块 (FCB) 或流控制块 (SCB) 。打开文件流时，文件系统会将指向 FCB 或 SCB 的指针存储在文件对象的 FsContext 成员中。

注意FsRtlGetPerStreamContextPointer 宏只能在支持高级 FCB 标头的文件系统上使用。

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