Partager via


FwpsNetBufferListAssociateContext0, fonction (fwpsk.h)

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 WFP Version-Independent Names and Targeting Specific Versions of 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 à 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 au pilote de légende FWPS_NET_BUFFER_LIST_NOTIFY_FN0.

[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 le pilote de légende FWPS_NET_BUFFER_LIST_NOTIFY_FN0 fonction. Le moteur de filtre envoie status notifications à cette fonction.

[in] flags

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

Valeur retournée

La fonction FwpsNetBufferListAssociateContext0 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 FwpsNetBufferListAssociateContext0 associe des groupes de paquets au pilote de légende. Les paquets intéressants 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.

Configuration requise

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

Voir aussi

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

Utilisation de l’étiquetage de paquets