NdisOffloadTcpForward, fonction (ndischimney.h)

Article
02/26/2024

[La fonctionnalité de déchargement de cheminée TCP est déconseillée et ne doit pas être utilisée.]

Un pilote de protocole ou un pilote intermédiaire appelle la fonction NdisOffloadTcpForward pour transférer les segments TCP reçus non connus vers un pilote ou une cible de déchargement sous-jacent.

Syntaxe

NDIS_STATUS NdisOffloadTcpForward(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Paramètres

[in] NdisOffloadHandle

Handle vers une structure de NDIS_OFFLOAD_HANDLE dans le contexte de l’appelant pour la connexion TCP déchargée. Pour plus d'informations, consultez la rubrique Référencement de l’état déchargé via un pilote intermédiaire.

[in] NetBufferList

Pointeur vers une structure NET_BUFFER_LIST . Cette structure peut être une structure autonome ou la première structure d’une liste liée de structures NET_BUFFER_LIST. Chaque structure NET_BUFFER_LIST de la liste décrit une structure NET_BUFFER . Chaque structure NET_BUFFER pointe vers une chaîne de listes de descripteurs mémoire (MDL). Les fichiers MDL associés à une structure de NET_BUFFER contiennent un seul segment TCP qui est transféré à la cible de déchargement. Le premier octet du premier MDL est le premier octet de l’en-tête TCP. Les NET_BUFFER_LIST et les structures associées sont verrouillées afin qu’elles restent résidentes dans la mémoire physique. Toutefois, elles ne sont pas mappées dans la mémoire système.

Valeur retournée

La fonction NdisOffloadTcpForward retourne toujours NDIS_STATUS_PENDING. L’opération de transfert est toujours effectuée de manière asynchrone.

Remarques

En réponse à un appel à sa fonction MiniportTcpOffloadForward , un pilote intermédiaire appelle la fonction NdisOffloadTcpForward pour propager l’opération de transfert vers le pilote sous-jacent ou la cible de déchargement. Pour plus d’informations, consultez Propagation des opérations d’E/S.

À la fonction NdisOffloadTcpForward , le pilote intermédiaire transmet ce qui suit :

Fonction NdisOffloadHandle qui référence la structure NDIS_OFFLOAD_HANDLE stockée dans le contexte du pilote intermédiaire pour la connexion TCP déchargée. Pour plus d'informations, consultez la rubrique Référencement de l’état déchargé via un pilote intermédiaire.
Le même pointeur de PNET_BUFFER_LIST que NDIS a passé au pilote intermédiaire Fonction MiniportTcpOffloadForward .

Lorsque le pilote ou la cible de déchargement sous-jacent termine par la suite l’opération de transfert en appelant la fonction NdisTcpOffloadForwardComplete , NDIS appelle la fonction ProtocolOffloadForwardComplete du pilote intermédiaire. Le pilote intermédiaire appelle ensuite la fonction NdisTcpOffloadForwardComplete pour propager l’achèvement de l’opération de transfert.