PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK回调函数（ntifs.h）

项目
12/21/2024

筛选器驱动程序可以将PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK类型的例程注册为筛选器驱动程序的 CleanupCallback 回调例程，用于额外的创建参数（ECP）上下文结构。

语法

PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK PfsrtlExtraCreateParameterCleanupCallback;

void PfsrtlExtraCreateParameterCleanupCallback(
  [in, out] PVOID EcpContext,
  [in[]     LPCGUID EcpType
)
{...}

参数

[in, out] EcpContext

分配 ECP 上下文结构的例程返回的 ECP 上下文指针。

[in[] EcpType

指向传递给分配 ECP 上下文结构的例程的 GUID 的指针，指示额外的创建参数类型。有关详细信息，请参阅在驱动程序中使用 GUID。

返回值

没有

言论

当筛选器驱动程序分配 ECP 上下文结构时，可以选择将PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK类型的例程指定为筛选器驱动程序的 CleanupCallback 回调例程。如果筛选器驱动程序指定 CleanupCallback 回调例程，则操作系统将调用 CleanupCallback 例程（无论 IRQ 级别如何）。此 CleanupCallback 例程在删除 ECP 上下文结构时执行与 ECP 上下文相关的任何必要的清理处理。

若要指定回调例程，筛选器驱动程序使用最初分配 ECP 上下文结构的例程的 CleanupCallback 参数传递指向回调例程的指针。如果不需要回调例程，则必须将 NULL 值传递给 CleanupCallback 参数。

以下例程支持PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK类型的回调例程：