FwpsNetBufferListRemoveContext0 函数 (fwpsk.h)

  • 项目

FwpsNetBufferListRemoveContext0 函数删除与网络缓冲区列表关联的上下文。

注意FwpsNetBufferListRemoveContext0 是 FwpsNetBufferListRemoveContext 的特定版本。 有关详细信息 ，请参阅 WFP Version-Independent 名称和面向特定版本的 Windows 。
 

语法

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

参数

[in, out, optional] netBufferList

一个网络缓冲区列表，指示标注驱动程序感兴趣的一个或多个数据包。 此参数是可选的，可以为 NULL。 如果为 NULL，则该函数将从所有关联的网络缓冲区列表中删除上下文。

[in] contextTag

在 contextTag 参数中传递给 FwpsNetBufferListAssociateContext0 的上下文标记。

[in] flags

此参数保留供将来使用，必须为零。

返回值

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

返回代码 说明
STATUS_SUCCESS
 已成功删除上下文。
其他状态代码
 出现了错误。

注解

FwpsNetBufferListRemoveContext0 函数异步删除与网络缓冲区列表关联的标记上下文。

若要将上下文与网络缓冲区列表相关联，请调用 FwpsNetBufferListAssociateContext0 或 FwpsNetBufferListAssociateContext1。

通常，标注驱动程序不需要使用此函数，因为当数据包在堆栈中移动时，标记的上下文会自动删除。 提供此函数，以便标注驱动程序可以在未自动删除上下文的情况下停止处理。 例如，对于 NDIS 筛选器驱动程序，数据包永远不会进入 TCP/IP 堆栈，并且需要通过调用 FwpsNetBufferListRemoveContext0 手动删除上下文，并将 netBufferList 参数设置为 NULL。

要求

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

另请参阅

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用数据包标记