通过

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0回调函数 (fwpsu.h)

  • 项目

筛选器引擎调用标注的 flowDeleteFn 标注函数来通知标注正在终止由标注处理的数据流。

语法

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 FwpsCalloutFlowDeleteNotifyFn0;

void FwpsCalloutFlowDeleteNotifyFn0(
  UINT16 layerId,
  UINT32 calloutId,
  UINT64 flowContext
)
{...}

参数

layerId

要终止数据流的筛选层的运行时标识符。 有关详细信息，请参阅 筛选层标识符。

calloutId

筛选器引擎中标注的运行时标识符。 此标识符与标注驱动程序调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数以向筛选器引擎注册标注时返回的标识符相同。

flowContext

通过调用 FwpsFlowAssociateContext0 函数与数据流关联的最新上下文。

返回值

无

备注

标注驱动程序通过调用 FwpsCalloutRegister0 或 FwpsCalloutRegister1 函数，将标注的标注函数注册到筛选器引擎。

筛选器引擎在终止数据流时调用标注的 flowDeleteFn 标注函数，以便标注可以清理与数据流关联的上下文。 例如，此标注函数将在 RST 突然停止后调用，而不会首先调用 classifyFn 。 仅当标注驱动程序将上下文与数据流关联时，筛选器引擎才会调用此标注函数。 当数据流终止时，筛选器引擎将自动从数据流中删除上下文。

仅当标注之前已添加到支持数据流的筛选层的筛选引擎中，并且标注驱动程序将上下文与其处理的数据流相关联时，筛选器引擎才会调用标注的 flowDeleteFn 标注函数。 如果标注驱动程序未将上下文与标注处理的数据流相关联，则不应为标注实现 flowDeleteFn 标注函数。 在这种情况下，标注驱动程序在向筛选器引擎注册标注时，应将FWPS_CALLOUT0结构的 flowDeleteFn 成员设置为 NULL。

FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0类型定义为指向 flowDeleteFn 函数的指针，如下所示。

typedef void (NTAPI *FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0) flowDeleteFn

筛选器引擎在 IRQL <= DISPATCH_LEVEL调用标注的 flowDeleteFn 标注函数。

要求

要求 值
Header fwpsu.h