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。 如果 FastMutexNULL,则调用方必须显式设置流上下文对象的 FastMutex 成员以指向现有快速互斥体。 (可以在调用 FsRtlSetupAdvancedHeader之前或之后执行此操作。

返回值

没有

言论

文件系统使用 FsRtlSetupAdvancedHeader 宏初始化 FSRTL_ADVANCED_FCB_HEADER 结构,以便与筛选器上下文一起使用。

不再需要高级 FCB 标头结构时,文件系统必须调用 FsRtlTeardownPerStreamContexts 释放所有关联的每个流上下文结构。

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

要求

要求 价值
最低支持的客户端 Windows XP
目标平台 桌面
标头 ntifs.h(包括 Ntifs.h、Fltkernel.h)
IRQL <= APC_LEVEL

另请参阅

FSRTL_ADVANCED_FCB_HEADER

FSRTL_PER_STREAM_CONTEXT

FsRtlGetPerStreamContextPointer

FsRtlInitPerStreamContext

FsRtlInsertPerStreamContext

FsRtlLookupPerStreamContext

FsRtlRemovePerStreamContext

FsRtlSupportsPerStreamContexts

FsRtlTeardownPerStreamContexts