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.
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 |
---|---|
|
L’association a réussi. |
|
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 FwpsNetBufferListRetrieveContext0Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour