Fonction FwpsInjectNetworkSendAsync0 (fwpsk.h)

Article
02/29/2024

La fonction FwpsInjectNetworkSendAsync0 injecte des données de paquet dans le chemin d’envoi des données.

RemarqueFwpsInjectNetworkSendAsync0 est une version spécifique de FwpsInjectNetworkSendAsync. Pour plus d’informations , voir PAM Version-Independent noms et Ciblage de versions spécifiques de Windows .

Syntaxe

NTSTATUS FwpsInjectNetworkSendAsync0(
  [in]           HANDLE                injectionHandle,
  [in, optional] HANDLE                injectionContext,
  [in]           UINT32                flags,
  [in]           COMPARTMENT_ID        compartmentId,
  [in, out]      NET_BUFFER_LIST       *netBufferList,
  [in]           FWPS_INJECT_COMPLETE0 completionFn,
  [in, optional] HANDLE                completionContext
);

Paramètres

[in] injectionHandle

Handle d’injection précédemment créé par un appel à la fonction FwpsInjectionHandleCreate0 avec le paramètre flags défini sur FWPS_INJECTION_TYPE_NETWORK.

[in, optional] injectionContext

Handle facultatif pour le contexte d’injection. Si elle est spécifiée, elle peut être obtenue en appelant la fonction FwpsQueryPacketInjectionState0 lorsque l’état d’injection de paquets FWPS_PACKET_INJECTION_STATE est FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF.

[in] flags

Réservé. Les pilotes de légende doivent définir ce paramètre sur zéro.

[in] compartmentId

Identificateur du compartiment de routage dans lequel les données de paquet sont injectées, spécifié en tant que type COMPARTMENT_ID . Cet identificateur est fourni à une légende via le membre compartmentId du FWPS_INCOMING_METADATA_VALUES0 structure passée à la fonction de légende classFn du pilote de légende. Si le membre compartmentId est disponible pour les légendes, FWPS_METADATA_FIELD_COMPARTMENT_ID sera défini dans le membre currentMetadataValues . Sinon, définissez ce paramètre sur UNSPECIFIED_COMPARTMENT_ID.

[in, out] netBufferList

Pointeur vers une structure de NET_BUFFER_LIST qui décrit les données de paquet injectées. Un pilote de légende alloue une structure NET_BUFFER_LIST à utiliser pour injecter des données de paquets en appelant la fonction FwpsAllocateCloneNetBufferList0 ou la fonction FwpsAllocateNetBufferAndNetBufferList0 . La structure NET_BUFFER_LIST doit commencer par un en-tête IP.

[in] completionFn

Pointeur vers une fonction de légende completionFn fournie par le pilote de légende. Le moteur de filtre appelle cette fonction après que les données de paquet, décrites par le paramètre NetBufferList , ont été injectées dans la pile réseau.

[in, optional] completionContext

Pointeur vers un contexte fourni par un pilote de légende qui est passé à la fonction de légende pointée par le paramètre completionFn . Ce paramètre est facultatif et peut être NULL.

Valeur retournée

La fonction FwpsInjectNetworkSendAsync0 retourne l’un des codes NTSTATUS suivants.

Code de retour	Description
STATUS_SUCCESS	L’injection de données de paquets a été lancée avec succès. Le moteur de filtre appelle la fonction d’achèvement une fois que le moteur de filtre a terminé d’injecter les données de paquet dans la pile réseau, ou lorsqu’une erreur s’est produite par la suite. En cas d’erreur, le membre Status de la structure NET_BUFFER_LIST terminée indique la raison de l’échec.
STATUS_FWP_TCPIP_NOT_READY	La pile réseau TCP/IP n’est pas prête à accepter l’injection de données de paquets.
STATUS_FWP_INJECT_HANDLE_CLOSING	La poignée d’injection est en cours de fermeture.
STATUS_FWP_INJECT_HANDLE_STALE	Le handle d’injection n’a pas été créé avec le paramètre Flags du Fonction FwpsInjectionHandleCreate0 définie sur FWPS_INJECTION_TYPE_NETWORK.
Autres codes status	Une erreur est survenue.

Remarques

Un pilote de légende appelle la fonction FwpsInjectNetworkSendAsync0 pour injecter des données de paquet réseau dans le chemin d’envoi des données. Cette fonction peut s’exécuter de manière asynchrone. Les pilotes de légende injectent normalement des données dans la pile réseau lors de la modification des données de paquets. Pour plus d’informations sur la façon dont un pilote de légende peut modifier les données de paquets, consultez Opérations du pilote de légende.

Si la valeur de retour n’est pas STATUS_SUCCESS, la fonction d’achèvement n’est pas appelée. Dans ce cas, la liste de mémoires tampons net pointée par netBufferList doit être libérée par un appel à FwpsFreeNetBufferList0 ou Fonctions FwpsFreeCloneNetBufferList0 .

Le paquet injecté peut être à nouveau indiqué au pilote de légende. Pour empêcher la boucle infinie, le pilote doit d’abord appeler le Fonction FwpsQueryPacketInjectionState0 avant d’appeler la fonction de légende classifyFn , et le pilote doit autoriser les paquets dont l’état d’injection FWPS_PACKET_INJECTION_STATE défini sur FWPS_PACKET_INJECTED_BY_SELF ou FWPS_PACKET_PREVIOUSLY_INJECTED_BY_SELF.

Configuration requise

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