FwpsNetBufferListRemoveContext0 函数 (fwpsk.h)

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

注意FwpsNetBufferListRemoveContext0FwpsNetBufferListRemoveContext 的特定版本。 有关详细信息 ,请参阅 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 函数异步删除与网络缓冲区列表关联的标记上下文。

若要将上下文与网络缓冲区列表相关联,请调用 FwpsNetBufferListAssociateContext0FwpsNetBufferListAssociateContext1

通常,标注驱动程序不需要使用此函数,因为当数据包在堆栈中移动时,标记的上下文会自动删除。 提供此函数,以便标注驱动程序可以在未自动删除上下文的情况下停止处理。 例如,对于 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

使用数据包标记