PFLT_CONTEXT_CLEANUP_CALLBACK回调函数 (fltkernel.h)

项目
02/26/2024

微筛选器驱动程序可以将 PFLT_CONTEXT_CLEANUP_CALLBACK 类型的例程注册为微筛选器驱动程序的 ContextCleanupCallback 例程。

语法

PFLT_CONTEXT_CLEANUP_CALLBACK PfltContextCleanupCallback;

void PfltContextCleanupCallback(
  [in] PFLT_CONTEXT Context,
  [in] FLT_CONTEXT_TYPE ContextType
)
{...}

参数

[in] Context

指向上下文中微筛选器驱动程序部分的指针。

[in] ContextType

上下文的类型。必须是以下值之一：

从 Windows Vista) 开始FLT_FILE_CONTEXT (

FLT_INSTANCE_CONTEXT

FLT_STREAM_CONTEXT

FLT_STREAMHANDLE_CONTEXT

从 Windows 8) 开始FLT_SECTION_CONTEXT (

从 Windows Vista) 开始FLT_TRANSACTION_CONTEXT (

FLT_VOLUME_CONTEXT

返回值

无

备注

微筛选器驱动程序可以选择将 PFLT_CONTEXT_CLEANUP_CALLBACK 类型的例程指定为微筛选器驱动程序在从 DriverEntry 例程调用 FltRegisterFilter 时注册的每种上下文类型的 ContextCleanupCallback 例程。若要指定此例程，微筛选器驱动程序会将指向该例程的指针存储在上下文类型的 FLT_CONTEXT_REGISTRATION 结构的 ContextCleanupCallback 成员中。

如果微筛选器驱动程序为上下文类型指定 ContextCleanupCallback 例程，筛选器管理器会在释放该类型的任何微筛选器驱动程序上下文之前调用此例程。在此例程中，微筛选器驱动程序执行任何所需的清理，例如释放微筛选器驱动程序在上下文结构中分配的额外内存。 在 ContextCleanupCallback 例程返回后，筛选器管理器释放上下文。

有关上下文注册的详细信息，请参阅 FLT_CONTEXT_REGISTRATION的参考条目。