FwpsNetBufferListRetrieveContext0, fonction (fwpsk.h)
La fonction FwpsNetBufferListRetrieveContext0 récupère le contexte associé à une liste de mémoires tampons réseau marquée dans une autre couche.
Syntaxe
NTSTATUS FwpsNetBufferListRetrieveContext0(
[in, out] NET_BUFFER_LIST *netBufferList,
[in] UINT64 contextTag,
[in] BOOLEAN removeContext,
[in] UINT32 flags,
[out] UINT64 *context
);
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. Si removeContext est défini, la liste de mémoires tampons réseau retournée aura le contexte supprimé.
[in] contextTag
Identificateur unique localement obtenu en appelant le fonction de FwpsNetBufferListGetTagForContext0. Il s’agit de la balise de contexte utilisée dans l’appel initial à FwpsNetBufferListAssociateContext0.
[in] removeContext
Si elle est définie, FwpsNetBufferListRetrieveContext0 supprime l’association de contexte en plus de récupérer le contexte.
[in] flags
Ce paramètre est réservé à une utilisation ultérieure et est défini sur zéro.
[out] context
Contexte affecté au paquet par le pilote de légende dans l’appel initial à FwpsNetBufferListAssociateContext0.
Valeur de retour
La fonction FwpsNetBufferListRetrieveContext0 retourne l’un des codes NTSTATUS suivants.
Retourner le code | Description |
---|---|
|
L’association a réussi. |
|
Une erreur s’est produite. |
Remarques
La fonction FwpsNetBufferListRetrieveContext0 récupère une liste de mémoires tampons réseau marquée dans une autre couche.
Vous pouvez également utiliser cette fonction pour supprimer l’association de contexte en définissant le paramètre removeContext.
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 |