FwpsNetBufferListAssociateContext0, fonction (fwpsk.h)

Article
02/07/2025

La fonction FwpsNetBufferListAssociateContext0 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.

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

Syntaxe

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 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_FN0.

[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 le pilote de légende FWPS_NET_BUFFER_LIST_NOTIFY_FN0 fonction. 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 FwpsNetBufferListAssociateContext0 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 FwpsNetBufferListAssociateContext0 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.

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

FwpsNetBufferListAssociateContext1

FwpsNetBufferListTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

à l’aide du balisage de paquets

Partager via