FsRtlTeardownPerFileContexts 函数 (ntifs.h)

文件系统调用FsRtlTeardownPerFileContexts 例程,以释放与文件控制块 关联的FSRTL_PER_FILE_CONTEXT 对象 (FCB) 结构。

语法

void FsRtlTeardownPerFileContexts(
  [in] PVOID *PerFileContextPointer
);

参数

[in] PerFileContextPointer

指向标识每个文件上下文结构的不透明指针的指针。 若要从文件对象检索此指针,请使用 FsRtlGetPerFileContextPointer 宏。

返回值

备注

此例程调用 FSRTL_PER_FILE_CONTEXT 对象中指定的 FreeCallback 例程。 FreeCallback 例程必须解除分配FSRTL_PER_FILE_CONTEXT结构和关联的上下文。

为了避免同步冲突, FsRtlTeardownPerFileContexts 例程在调用 FreeCallback 之前释放每个文件上下文对象的锁。 这可以避免阻止通过筛选器对其自己的列表操作(例如使用 FsRtlRemovePerFileContext 删除)访问每个文件上下文对象。

要求

要求
最低受支持的客户端 从 Windows Vista 开始可用。
目标平台 通用
标头 ntifs.h (包括 FltKernel.h、Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <=APC_LEVEL

另请参阅

FSRTL_PER_FILE_CONTEXT

PFREE_FUNCTION

在旧版文件系统筛选器驱动程序中跟踪 Per-File 上下文