FwpsNetBufferListRemoveContext0, fonction (fwpsk.h)

Article
02/26/2024

La fonction FwpsNetBufferListRemoveContext0 supprime le contexte associé à une liste de mémoires tampons réseau.

RemarqueFwpsNetBufferListRemoveContext0 est une version spécifique de FwpsNetBufferListRemoveContext. Pour plus d’informations , consultez WFP Version-Independent Names and Targeting Specific Versions of Windows .

Syntaxe

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

Paramètres

[in, out, optional] netBufferList

Liste de mémoires tampons réseau qui indique un ou plusieurs paquets d’intérêt pour le pilote de légende. Ce paramètre est facultatif et peut être NULL. Si elle est NULL, la fonction supprime le contexte de toutes les listes de mémoires tampons réseau associées.

[in] contextTag

Balise de contexte qui a été passée dans le paramètre contextTag à FwpsNetBufferListAssociateContext0.

[in] flags

Ce paramètre est réservé pour une utilisation ultérieure et doit être égal à zéro.

Valeur retournée

La fonction FwpsNetBufferListRemoveContext0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	Le contexte a été supprimé avec succès.
Autres codes status	Une erreur est survenue.

Remarques

La fonction FwpsNetBufferListRemoveContext0 supprime de façon asynchrone le contexte balisé associé à une liste de mémoires tampons réseau.

Pour associer un contexte à une liste de mémoires tampons réseau, appelez FwpsNetBufferListAssociateContext0 ou FwpsNetBufferListAssociateContext1.

En règle générale, un pilote de légende n’a pas besoin d’utiliser cette fonction, car le contexte balisé est automatiquement supprimé lorsque les paquets se déplacent dans la pile. Cette fonction est fournie afin qu’un pilote de légende puisse arrêter le traitement dans les situations où les contextes ne sont pas supprimés automatiquement. Par exemple, dans le cas d’un pilote de filtre NDIS, les paquets n’entrent jamais dans la pile TCP/IP, et les contextes doivent être supprimés manuellement en appelant FwpsNetBufferListRemoveContext0 avec le paramètre netBufferList défini surNULL.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible à partir de Windows 7.
Plateforme cible	Universal
En-tête	fwpsk.h (include Fwpsk.h)
Bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Utilisation de l’étiquetage de paquets

Partager via