NdisOffloadTcpForward, fonction (ndischimney.h)
[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 des segments TCP reçus non connus vers un pilote sous-jacent ou une cible de déchargement.
Syntaxe
NDIS_STATUS NdisOffloadTcpForward(
[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 structure NET_BUFFER. Chaque structure NET_BUFFER pointe vers une chaîne de descripteurs de mémoire (MDLs). Les DLL associées à une structure 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ésident dans la mémoire physique. Toutefois, ils ne sont pas mappés à la mémoire système.
Valeur de retour
La fonction NdisOffloadTcpForward retourne toujours NDIS_STATUS_PENDING. L’opération de transfert est toujours terminée de façon 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 ou la cible de déchargement sous-jacente. Pour plus d’informations, consultez propagation des opérations d’E/S.
Dans la fonction NdisOffloadTcpForward, le pilote intermédiaire passe les éléments suivants :
- Fonction 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é au pilote intermédiaire fonction MiniportTcpOffloadForward.
Exigences
Exigence | Valeur |
---|---|
plateforme cible | Universel |
d’en-tête | ndischimney.h (include Ndischimney.h) |
bibliothèque | Ndis.lib |