通过

FWPS_CALLOUT_CLASSIFY_FN3回调函数 （fwpsk.h）

  • 项目

标注筛选器匹配时在分类期间调用的回调函数的版本 3。 此回调返回 FWPS_FILTER3 结构的差异。

语法

FWPS_CALLOUT_CLASSIFY_FN3 FwpsCalloutClassifyFn3;

void FwpsCalloutClassifyFn3(
  const FWPS_INCOMING_VALUES0 *inFixedValues,
  const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  void *layerData,
  const void *classifyContext,
  const FWPS_FILTER3 *filter,
  UINT64 flowContext,
  FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

参数

inFixedValues

指向 FWPS_INCOMING_VALUES0 结构的指针。 此结构包含所筛选层中每个数据字段的值。

inMetaValues

指向 FWPS_INCOMING_METADATA_VALUES0 结构的指针。 此结构包含所筛选层中每个元数据字段的值。

layerData

指向描述所筛选层的原始数据的结构的指针。 此参数可能 NULL，具体取决于要筛选的层，以及调用 classifyFn3 标注函数的条件。 对于流层，此参数指向 FWPS_STREAM_CALLOUT_IO_PACKET0 结构。 对于所有其他层，如果此参数不 NULL，则此参数指向 NET_BUFFER_LIST 结构。

classifyContext

指向筛选器引擎与标注驱动程序关联的上下文数据的指针。

filter

指向 FWPS_FILTER3 结构的指针。 此结构描述指定筛选器操作标注的筛选器。

flowContext

包含与数据流关联的上下文的 UINT64 类型变量。 如果没有与数据流关联的上下文，则此参数为零。 如果在不支持数据流的筛选层上将标注添加到筛选器引擎，分类Fn3 标注函数应忽略此参数。

classifyOut

指向 FWPS_CLASSIFY_OUT0 结构的指针，该结构接收 分类Fn3 标注函数返回给调用方的任何数据。

返回值

没有

言论

标注驱动程序通过调用 FwpsCalloutRegister2 函数向筛选器引擎注册标注函数。

筛选器引擎调用标注的 分类Fn3 标注函数，每当筛选器引擎中指定筛选器操作标注的筛选器满足所有测试条件时，都要处理数据。

标注的 分类Fn1 标注函数应清除以下任一情况下 FWPS_CLASSIFY_OUT0 结构成员 权限 成员中的 FWPS_RIGHT_ACTION_WRITE 标志：

  • 当 分类Fn1 标注函数将 FWPS_CLASSIFY_OUT0 结构的 actionType 成员设置为 FWP_ACTION_BLOCK时。
  • 当 分类Fn1 标注函数将 FWPS_CLASSIFY_OUT0 结构的 actionType 成员设置为 FWP_ACTION_PERMIT，并在 FWPS_FILTER3 结构的标志成员中设置 FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT 标志。
  • 当标注指示它打算通过在调用 FwpsReferenceNetBufferList0 函数时将 intendToModify 参数设置为 TRUE 来修改克隆 net 缓冲区列表。

要求

要求 价值
最低支持的客户端 从 Windows Vista 开始可用。
标头 fwpsk.h
IRQL <= DISPATCH_LEVEL

另请参阅