FwpsNetBufferListAssociateContext0 函数 (fwpsk.h)

  • 项目

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

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

语法

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 notifyFn,
  [in]      UINT32                          flags
);

参数

[in, out] netBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

providerGuid

提供程序 GUID。

[in, out] deviceObject

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

[in] notifyFn

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

[in] flags

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

返回值

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

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

注解

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

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

要求

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

另请参阅

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用数据包标记