FwpsNetBufferListAssociateContext1 函数 (fwpsk.h)

  • 项目

FwpsNetBufferListAssociateContext1 函数将标注驱动程序的上下文与网络缓冲区列表相关联，并为网络缓冲区列表事件配置通知。

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

 

语法

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

参数

[in, out] netBufferList

一个网络缓冲区列表，指示标注驱动程序感兴趣的一个或多个数据包。

[in] layerId

在其中关联上下文的层的标识符。 从 NDIS 接收路径调用此函数时，请将此参数设置为 FWPS_LAYER_NON_WFP。

[in] context

标注驱动程序设置的任意上下文信息。 筛选器引擎会将此上下文传递给标注驱动程序的
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函数。

[in] contextTag

通过调用 获取的本地唯一标识符 FwpsNetBufferListGetTagForContext0 函数。

providerGuid

提供程序 GUID。

[in, out] deviceObject

指向标注驱动程序的设备对象的指针。

[in] notifyFn

指向标注驱动程序的 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 函数的指针。 筛选器引擎将向此函数发送状态通知。

[in] flags

此参数保留供将来使用，并设置为零。

返回值

FwpsNetBufferListAssociateContext1 函数返回以下 NTSTATUS 代码之一。

返回代码 说明
STATUS_SUCCESS
 关联成功。
其他状态代码
 出现了错误。

注解

FwpsNetBufferListAssociateContext1 函数将数据包组与标注驱动程序相关联。 可以跟踪感兴趣的数据包，以便通过堆栈中的多个层进行检查。

在调用此函数之前，必须调用 FwpsNetBufferListGetTagForContext0 函数以获取上下文标记。

此函数实质上与以前的版本相同，

FwpsNetBufferListAssociateContext0。 唯一的区别是 notifyFn 参数指向的更新FWPS_NET_BUFFER_LIST_NOTIFY_FN1函数。

要求

要求 值
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 fwpsk.h (包括 Fwpsk.h)
Library Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用数据包标记