通过

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）
库 Fwpkclnt.lib
IRQL <= DISPATCH_LEVEL

另请参阅

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

使用数据包标记