通过

FWPS_NET_BUFFER_LIST_NOTIFY_FN1回调函数 （fwpsk.h）

  • 项目

筛选器引擎调用 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 标注函数，以通知标注驱动程序与标注标记的数据包关联的事件。

注释 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 是 Windows 8 及更高版本中使用的特定版本的 FWPS_NET_BUFFER_LIST_NOTIFY_FN。 有关详细信息，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows。 对于 Windows 7，FWPS_NET_BUFFER_LIST_NOTIFY_FN0 可用。

 

语法

FWPS_NET_BUFFER_LIST_NOTIFY_FN1 FwpsNetBufferListNotifyFn1;

NTSTATUS FwpsNetBufferListNotifyFn1(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out]           NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

参数

[in] eventType

一个值，该值指示筛选器引擎发送到标注的通知类型。 此参数将设置为其中一个值 FWPS_NET_BUFFER_LIST_EVENT_TYPE0 枚举。

[in, out] netBufferList

指向缓冲区列表的指针，其中包含之前被标注驱动程序标记为有趣的数据包。

[in, out, optional] newNetBufferList

指向更新的缓冲区列表的指针，其中包含对标注驱动程序感兴趣的数据包。 此参数的使用因事件类型而异。 对于对指示的数据包进行更改的事件，更改的版本将作为此参数传递。

[in] layerId

从中调用通知函数的层。

[in] context

用于标记感兴趣的数据包的上下文。 此值是由标注驱动程序分配给数据包的值，用于标识数据包。

[in] contextTag

用于将感兴趣的数据包与标注驱动程序的上下文关联的上下文标记。

返回值

标注的 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函数返回以下 NTSTATUS 代码之一。

返回代码 描述
STATUS_SUCCESS
 标注驱动程序接受来自筛选器引擎的通知。
其他状态代码
 发生错误。

言论

通过调用 FwpsNetBufferListAssociateContext1，此函数与标注驱动程序相关联。 标注驱动程序可以使用单个通知函数来处理多个关联的缓冲区列表的消息，方法是使用上下文和上下文标记来区分实例。

此函数与 FWPS_NET_BUFFER_LIST_NOTIFY_FN0相同，但返回类型 NTSTATUS 而不是 VOID。

要求

要求 价值
最低支持的客户端 从 Windows 8 开始可用。
目标平台 窗户
标头 fwpsk.h （包括 Fwpsk.h）
IRQL <= DISPATCH_LEVEL

另请参阅

标注驱动程序标注函数

FWPS_NET_BUFFER_LIST_EVENT_TYPE0

FWPS_NET_BUFFER_LIST_NOTIFY_FN0

FwpsNetBufferListAssociateContext1

使用数据包标记