FwpsNetBufferListRetrieveContext0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsNetBufferListRetrieveContext0 récupère le contexte associé à une liste de mémoires tampons réseau marquée dans une autre couche.

RemarqueFwpsNetBufferListRetrieveContext0 est une version spécifique de FwpsNetBufferListRetrieveContext. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows.

Syntaxe

NTSTATUS FwpsNetBufferListRetrieveContext0(
  [in, out] NET_BUFFER_LIST *netBufferList,
  [in]      UINT64          contextTag,
  [in]      BOOLEAN         removeContext,
  [in]      UINT32          flags,
  [out]     UINT64          *context
);

Paramètres

[in, out] netBufferList

Liste de mémoires tampons réseau qui indique un ou plusieurs paquets d’intérêt pour le pilote de légende. Si removeContext est défini, la liste de mémoires tampons réseau retournée aura le contexte supprimé.

[in] contextTag

Identificateur unique localement obtenu en appelant le fonction de FwpsNetBufferListGetTagForContext0. Il s’agit de la balise de contexte utilisée dans l’appel initial à FwpsNetBufferListAssociateContext0.

[in] removeContext

Si elle est définie, FwpsNetBufferListRetrieveContext0 supprime l’association de contexte en plus de récupérer le contexte.

[in] flags

Ce paramètre est réservé à une utilisation ultérieure et est défini sur zéro.

[out] context

Contexte affecté au paquet par le pilote de légende dans l’appel initial à FwpsNetBufferListAssociateContext0.

Valeur de retour

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

Retourner le code	Description
STATUS_SUCCESS	L’association a réussi.
Autres codes d’état	Une erreur s’est produite.

Remarques

La fonction FwpsNetBufferListRetrieveContext0 récupère une liste de mémoires tampons réseau marquée dans une autre couche.

Vous pouvez également utiliser cette fonction pour supprimer l’association de contexte en définissant le paramètre removeContext.

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

FwpsNetBufferListAssociateContext0 FwpsNetBufferListTagForContext0 FwpsNetBufferListRemoveContext0

NET_BUFFER_LIST

Partager via