(fwpsk.h) FWPS_CALLOUT2 结构

项目
02/26/2024

FWPS_CALLOUT2 结构定义标注驱动程序向筛选器引擎注册标注所需的数据。

注意FWPS_CALLOUT2 是Windows 8 及更高版本中使用的特定FWPS_CALLOUT版本。有关详细信息，请参阅 WFP Version-Independent 名称和面向 Windows 的特定版本。对于 Windows 7，FWPS_CALLOUT1 可用。对于 Windows Vista，FWPS_CALLOUT0 可用。

语法

typedef struct FWPS_CALLOUT2_ {
  GUID                                calloutKey;
  UINT32                              flags;
  FWPS_CALLOUT_CLASSIFY_FN2           classifyFn;
  FWPS_CALLOUT_NOTIFY_FN2             notifyFn;
  FWPS_CALLOUT_FLOW_DELETE_NOTIFY_FN0 flowDeleteFn;
} FWPS_CALLOUT2;

成员

calloutKey

标注驱动程序定义的 GUID ，用于唯一标识标注。

flags

指定特定于标注的参数的标志。可能的标志包括：

值	含义
FWP_CALLOUT_FLAG_CONDITIONAL_ON_FLOW 0x00000001	标注驱动程序可以在注册将在支持数据流的层中添加的标注时指定此标志。如果指定了此标志，则仅当存在与数据流关联的上下文时，筛选器引擎才会调用标注驱动程序的分类Fn2 标注函数。标注驱动程序通过调用 FwpsFlowAssociateContext0 函数将上下文与数据流相关联。
FWP_CALLOUT_FLAG_ALLOW_OFFLOAD 0x00000002	标注驱动程序指定此标志以指示标注驱动程序的分类Fn2 标注函数不受影响，将网络数据处理卸载到支持卸载的网络接口卡 (NIC) 。如果未指定此标志，则为指定筛选器操作标注的任何筛选器处理的所有流量禁用网络数据处理卸载。
FWP_CALLOUT_FLAG_ENABLE_COMMIT_ADD_NOTIFY 0x00000004	标注驱动程序指定此标志以指示它可以接收有关在事务中添加的对象和筛选器的通知。提交事务后，筛选器引擎会发送通知。
FWP_CALLOUT_FLAG_ALLOW_MID_STREAM_INSPECTION 0x00000008	标注驱动程序指定此标志，以指示它可以在流级别对数据流执行动态流检查。请参阅Stream检查。
FWP_CALLOUT_FLAG_ALLOW_RECLASSIFY 0x00000010	标注驱动程序指定此标志来注册自身，以在重新分类现有套接字操作时调用。
FWP_CALLOUT_FLAG_RESERVED1 0x00000020	预留给系统使用。标注驱动程序应忽略此标志。
FWP_CALLOUT_FLAG_ALLOW_RSC 0x00000040	标注驱动程序指定此标志以指示标注支持 TCP 接收段合并 (RSC) 最大为 64K 的大型数据包。如果未指定此标志，并且注册了标注，则为指定筛选器操作标注的任何筛选器处理的所有流量禁用 RSC。
FWP_CALLOUT_FLAG_ALLOW_L2_BATCH_CLASSIFY 0x00000080	标注驱动程序在注册将在第 2 层添加的标注时指定此标志，以指示其分类Fn2 标注函数可以对多个链接 NET_BUFFER_LIST 结构进行分类。有关详细信息，请参阅使用第 2 层筛选。警告如果标注驱动程序设置此标志，则它不能使用以下函数修改NET_BUFFER_LISTs。 FwpsReferenceNetBufferList0 FwpsDereferenceNetBufferList0 FwpsAllocateCloneNetBufferList0 FwpsFreeCloneNetBufferList0 设置此标志后， FwpsAllocateCloneNetBufferList0 将始终返回 INVALID_PARAMETER 错误。这可能会意外地导致第三方标注驱动程序无法管理NET_BUFFER_LISTs的引用计数，从而导致发送和接收操作停止。
FWP_CALLOUT_FLAG_ALLOW_USO 0x00000100	标注驱动程序指定此标志以指示标注支持 UDP 分段卸载 (具有大于网络媒体 MTU 的数据包的 USO) 。如果未指定此标志，并且注册了标注，则为指定筛选器操作标注的任何筛选器处理的所有流量禁用 USO。注意：支持此标志的最早版本是Windows Insider Preview版本 10.0.25876。
FWP_CALLOUT_FLAG_ALLOW_URO 0x00000200	标注驱动程序指定此标志以指示标注支持 UDP 接收卸载 (URO) 最大为 64K 的大型数据包。如果未指定此标志，并且注册了标注，则为指定筛选器操作标注的任何筛选器处理的所有流量禁用 URO。注意：如果指定了此标志，则标注不得克隆并重新输入入站 URO 数据包。