FwpsNetBufferListRemoveContext0 function

The FwpsNetBufferListRemoveContext0 function removes the context associated with a network buffer list.

Note  FwpsNetBufferListRemoveContext0 is a specific version of FwpsNetBufferListRemoveContext. See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.
 

Syntax

NTSTATUS FwpsNetBufferListRemoveContext0(
  NET_BUFFER_LIST *netBufferList,
  UINT64          contextTag,
  UINT32          flags
);

Parameters

netBufferList

A network buffer list that indicates one or more packets of interest to the callout driver. This parameter is optional and can be NULL. If it is NULL, the function will remove the context from all associated network buffer lists.

contextTag

The context tag that was passed in the contextTag parameter to FwpsNetBufferListAssociateContext0.

flags

This parameter is reserved for future use and must be zero.

Return Value

The FwpsNetBufferListRemoveContext0 function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS
The context was successfully removed.
Other status codes
An error occurred.

Remarks

The FwpsNetBufferListRemoveContext0 function asynchronously removes the tagged context associated with a network buffer list.

To associate a context with a network buffer list, call FwpsNetBufferListAssociateContext0 or FwpsNetBufferListAssociateContext1.

Usually a callout driver will not need to use this function, because the tagged context is removed automatically when the packets move through the stack. This function is provided so that a callout driver can stop processing in situations where contexts aren't removed automatically. For example, in the case of an NDIS filter driver, the packets never enter the TCP/IP stack, and the contexts will need to be removed manually by calling FwpsNetBufferListRemoveContext0 with the netBufferList parameter set to NULL.

Requirements

   
Minimum supported client Available starting with Windows 7.
Target Platform Universal
Header fwpsk.h (include Fwpsk.h)
Library Fwpkclnt.lib
IRQL "<= DISPATCH_LEVEL"

See Also

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Using Packet Tagging