FwpsNetBufferListAssociateContext1, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsNetBufferListAssociateContext1 associe le contexte du pilote de légende à une liste de mémoires tampons réseau et configure la notification pour les événements de liste de mémoires tampons réseau.

RemarqueFwpsNetBufferListAssociateContext1 est la version spécifique de FwpsNetBufferListAssociateContext utilisé dans Windows 8 et versions ultérieures. Pour plus d’informations, consultez PAM Version-Independent noms et ciblage de versions spécifiques de Windows. Pour Windows 7, FwpsNetBufferListAssociateContext0 est disponible.

Syntaxe

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

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.

[in] layerId

Identificateur de la couche dans laquelle le contexte est associé. Lors de l’appel de cette fonction à partir du chemin de réception NDIS, définissez ce paramètre sur FWPS_LAYER_NON_WFP.

[in] context

Informations de contexte arbitraires définies par le pilote de légende. Le moteur de filtre transmet ce contexte au pilote de légende
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fonction.

[in] contextTag

Identificateur unique localement obtenu en appelant le fonction de FwpsNetBufferListGetTagForContext0.

providerGuid

GUID du fournisseur.

[in, out] deviceObject

Pointeur vers l’objet de périphérique du pilote de légende.

[in] notifyFn

Pointeur vers la fonction FWPS_NET_BUFFER_LIST_NOTIFY_FN1 du pilote de légende. Le moteur de filtre envoie des notifications d’état à cette fonction.

[in] flags

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

Valeur de retour

La fonction FwpsNetBufferListAssociateContext1 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 FwpsNetBufferListAssociateContext1 associe des groupes de paquets au pilote de légende. Les paquets d’intérêt peuvent être suivis pour l’inspection via plusieurs couches de la pile.

Avant d’appeler cette fonction, la fonction FwpsNetBufferListGetTagForContext0 doit être appelée pour obtenir une balise de contexte.

Cette fonction est essentiellement identique à la version précédente,

FwpsNetBufferListAssociateContext0. La seule différence est la fonction FWPS_NET_BUFFER_LIST_NOTIFY_FN1 mise à jour pointée par le paramètre notifyFn.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 8.
plateforme cible	Universel
d’en-tête	fwpsk.h (include Fwpsk.h)
bibliothèque	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Voir aussi

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

à l’aide du balisage de paquets

Partager via