FsRtlSetupAdvancedHeaderEx 宏 (ntifs.h)
文件系统使用 FsRtlSetupAdvancedHeaderEx 宏初始化 FSRTL_ADVANCED_FCB_HEADER 结构,以用于流上下文和文件上下文。
语法
void FsRtlSetupAdvancedHeaderEx(
_advhdr,
_fmutx,
_fctxptr
);
参数
_advhdr
指向要初始化 FSRTL_ADVANCED_FCB_HEADER 结构的指针。
_fmutx
指向初始化的快速互斥体的指针,该互斥体将用于同步对某些 FSRTL_ADVANCED_FCB_HEADER 成员的访问。 必须从非分页池分配快速互斥体。 此参数是可选的,可以 NULL。 如果调用方打算使用现有的快速互斥体对象,则调用方应将此参数设置为 NULL。 如果 FastMutexNULL,则调用方必须显式设置 FSRTL_ADVANCED_FCB_HEADER 结构(包含在流上下文对象中)的 FastMutex 成员,以指向现有的快速互斥体。 (可以在调用 FsRtlSetupAdvancedHeaderEx之前或之后执行此操作。
_fctxptr
指向文件系统运行时库 (FSRTL) 用于跟踪文件上下文的指针字段的指针。 此参数是可选的,可以 NULL。 特别:
对于在 Windows Vista 之前发布的 Microsoft Windows 操作系统,调用方必须将此参数设置为 NULL。
对于从 Windows Vista 开始的 Windows 操作系统:如果 FileContextSupportPointer 未 NULL,FileContextSupportPointer 必须是指向创建结构的文件系统的每个文件结构内的 PVOID 变量的指针。 若要指示文件系统驱动程序不支持文件上下文,调用方必须将 fileContextSupportPointer 设置为 NULL。
返回值
没有
言论
文件系统使用 FsRtlSetupAdvancedHeaderEx 宏初始化FSRTL_ADVANCED_FCB_HEADER结构,以用于流和文件上下文。
不再需要高级 FCB 标头结构时,文件系统必须调用 FsRtlTeardownPerStreamContexts 以释放所有关联的流和文件上下文结构。
有关详细信息,请参阅旧文件系统筛选器驱动程序中的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Microsoft Windows 2000 Service Pack 4(SP4)的更新汇总;Windows XP |
目标平台 | 桌面 |
标头 | ntifs.h(包括 Ntifs.h、Fltkernel.h) |
IRQL | PASSIVE_LEVEL |
另请参阅
FsRtlGetPerStreamContextPointer