Fonction FwpsNetBufferListAssociateContext1 (fwpsk.h)

Article
03/01/2024

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ée dans Windows 8 et versions ultérieures. Pour plus d’informations , voir 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 à laquelle le contexte est associé. Lorsque vous appelez 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 à la légende du pilote
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 fonction.

[in] contextTag

Identificateur unique localement obtenu en appelant le Fonction 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 status notifications à cette fonction.

[in] flags

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

Valeur retournée

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

Code de retour	Description
STATUS_SUCCESS	L’association a réussi.
Autres codes status	Une erreur est survenue.

Remarques

La fonction FwpsNetBufferListAssociateContext1 associe des groupes de paquets au pilote de légende. Les paquets d’intérêt peuvent être suivis à des fins d’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 .

Configuration requise

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