PFLT_NORMALIZE_CONTEXT_CLEANUP回调函数 (fltkernel.h)

项目
02/29/2024

为筛选器管理器的名称缓存提供文件名的微筛选器驱动程序可以将 PFLT_NORMALIZE_CONTEXT_CLEANUP 类型的例程注册为微筛选器驱动程序的 NormalizeContextCleanupCallback 例程。

语法

PFLT_NORMALIZE_CONTEXT_CLEANUP PfltNormalizeContextCleanup;

void PfltNormalizeContextCleanup(
  [in, optional] PVOID *NormalizationContext
)
{...}

参数

[in, optional] NormalizationContext

指向微筛选器驱动程序提供的上下文信息的指针，该信息将在对 PFLT_NORMALIZE_NAME_COMPONENT 回调例程的任何调用中传递，这些调用用于规范化同一文件名路径中的多个组件。

返回值

无

备注

为了注册此回调例程，微筛选器驱动程序将类型为 PFLT_NORMALIZE_CONTEXT_CLEANUP 的例程的地址存储在微筛选器驱动程序作为参数传递给 FltRegisterFilter 的 FLT_REGISTRATION 结构的 NormalizeContextCleanupCallback 成员中。

筛选器管理器调用此回调例程以允许微筛选器驱动程序对PFLT_NORMALIZE_NAME_COMPONENT回调例程的 NormalizationContext 参数中传递的上下文信息执行任何所需的清理。此上下文由微筛选器驱动程序在调用其PFLT_NORMALIZE_NAME_COMPONENT回调例程时设置。