NdisOffloadTcpSend, fonction (ndischimney.h)

Article
02/07/2025

[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 NdisOffloadTcpSend pour transmettre des données sur une connexion TCP déchargée.

Syntaxe

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

Paramètres

[in] NdisOffloadHandle

Handle vers une structure NDIS_OFFLOAD_HANDLE dans le contexte de l’appelant pour la connexion TCP déchargée. Pour plus d’informations, consultez référencement de l’état déchargé par le biais d’unde 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 liste de structures NET_BUFFER. Chaque structure NET_BUFFER dans la liste pointe vers une chaîne de listes de descripteurs de mémoire (MDL). Les MDL contiennent les données à transmettre. Les NET_BUFFER_LIST et les structures associées sont verrouillées afin qu’elles restent résident dans la mémoire physique. Toutefois, ils ne sont pas mappés à la mémoire système.

Valeur de retour

La fonction NdisOffloadTcpSend retourne toujours NDIS_STATUS_PENDING. L’opération d’envoi est toujours terminée de façon asynchrone.

Remarques

En réponse à un appel à sa fonction MiniportTcpOffloadSend, un pilote intermédiaire appelle la fonction NdisOffloadTcpSend pour propager l’opération d’envoi au pilote intermédiaire ou à la cible de déchargement sous-jacente. Pour plus d’informations, consultez propagation des opérations d’E/S.

Dans la fonction NdisOffloadTcpSend, le pilote intermédiaire passe les éléments suivants :

Un NdisOffloadHandle qui fait 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 référencement de l’état déchargé par le biais d’unde pilote intermédiaire.
Le même pointeur PNET_BUFFER_LIST que NDIS a passé à la fonction MiniportTcpOffloadSend du pilote intermédiaire.

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