FsRtlSetupAdvancedHeader 函数 (ntifs.h)
文件系统使用 FsRtlSetupAdvancedHeader 宏初始化 FSRTL_ADVANCED_FCB_HEADER 结构,以便与筛选器上下文配合使用。
语法
void FsRtlSetupAdvancedHeader(
PVOID AdvHdr,
PFAST_MUTEX FMutex
);
参数
AdvHdr
指向要初始化 的FSRTL_ADVANCED_FCB_HEADER 结构的指针。
FMutex
指向初始化的快速互斥体的指针,该互斥体将用于同步 对FSRTL_ADVANCED_FCB_HEADER 结构的访问。 必须从非分页池中分配快速互斥。
此参数可以为 NULL。 如果调用方打算使用现有的快速互斥对象,则应将此参数设置为 NULL 。 如果 FastMutex 为 NULL,则调用方必须将流上下文对象的 FastMutex 成员显式设置为指向现有的快速互斥体。 (可以在调用 FsRtlSetupAdvancedHeader.) 之前或之后执行此操作
返回值
无
备注
文件系统使用 FsRtlSetupAdvancedHeader 宏初始化用于筛选器上下文 的FSRTL_ADVANCED_FCB_HEADER 结构。
不再需要高级 FCB 标头结构时,文件系统必须调用 FsRtlTeardownPerStreamContexts 以释放所有关联的每流上下文结构。
有关详细信息,请参阅 在旧版文件系统筛选器驱动程序中跟踪 Per-Stream 上下文。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
目标平台 | 桌面 |
标头 | ntifs.h (包括 Ntifs.h、Fltkernel.h) |
IRQL | <= APC_LEVEL |
另请参阅
FsRtlGetPerStreamContextPointer