FwpsNetBufferListRemoveContext0, fonction (fwpsk.h)
La fonction FwpsNetBufferListRemoveContext0 supprime le contexte associé à une liste de mémoires tampons réseau.
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. S’il s’agit NULL, la fonction supprime le contexte de toutes les listes de mémoires tampons réseau associées.
[in] contextTag
Balise de contexte 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 de retour
La fonction FwpsNetBufferListRemoveContext0 retourne l’un des codes NTSTATUS suivants.
| Retourner le code | Description |
|---|---|
|
Le contexte a été supprimé avec succès. |
|
Une erreur s’est produite. |
Remarques
La fonction FwpsNetBufferListRemoveContext0 supprime de manière asynchrone le contexte marqué 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 marqué est supprimé automatiquement lorsque les paquets passent par la pile. Cette fonction est fournie afin qu’un pilote de légende puisse arrêter le traitement dans des 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 devront être supprimés manuellement en appelant FwpsNetBufferListRemoveContext0 avec le paramètre netBufferList défini sur NULL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 7. |
| plateforme cible | Universel |
| d’en-tête | fwpsk.h (include Fwpsk.h) |
| bibliothèque | Fwpkclnt.lib |
| IRQL | <= DISPATCH_LEVEL |
Voir aussi
FwpsNetBufferListAssociateContext0FwpsNetBufferListAssociateContext1
FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0