PFSRTL_EXTRA_CREATE_PARAMETER_CLEANUP_CALLBACK回调函数 (ntifs.h)

项目
02/26/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

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

返回值

无

备注

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

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

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