FwpsNetBufferListRemoveContext0 函数 (fwpsk.h)
FwpsNetBufferListRemoveContext0 函数删除与网络缓冲区列表关联的上下文。
语法
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 代码之一。
返回代码 | 说明 |
---|---|
|
已成功删除上下文。 |
|
出现了错误。 |
注解
FwpsNetBufferListRemoveContext0 函数异步删除与网络缓冲区列表关联的标记上下文。
若要将上下文与网络缓冲区列表相关联,请调用 FwpsNetBufferListAssociateContext0 或 FwpsNetBufferListAssociateContext1。
通常,标注驱动程序不需要使用此函数,因为当数据包在堆栈中移动时,标记的上下文会自动删除。 提供此函数,以便标注驱动程序可以在未自动删除上下文的情况下停止处理。 例如,对于 NDIS 筛选器驱动程序,数据包永远不会进入 TCP/IP 堆栈,并且需要通过调用 FwpsNetBufferListRemoveContext0 手动删除上下文,并将 netBufferList 参数设置为 NULL。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 从 Windows 7 开始可用。 |
目标平台 | 通用 |
标头 | fwpsk.h (包括 Fwpsk.h) |
Library | Fwpkclnt.lib |
IRQL | <= DISPATCH_LEVEL |
另请参阅
FwpsNetBufferListAssociateContext0FwpsNetBufferListAssociateContext1
FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0