FwpsNetBufferListAssociateContext0, fonction (fwpsk.h)

Article
02/29/2024

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

Partager via