Partager via

TCP_OFFLOAD_EVENT_HANDLER fonction de rappel (ndischimney.h)

  • Article

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

NDIS appelle la fonction ProtocolIndicateOffloadEvent d’un pilote de protocole ou intermédiaire pour publier une indication qui a été lancée par l’appel d’un pilote ou du déchargement cible sous-jacent à l’appel de la cible fonction NdisTcpOffloadEventHandler.

Syntaxe

TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;

void TcpOffloadEventHandler(
  [in] IN PVOID OffloadContext,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

Paramètres

[in] OffloadContext

Pointeur vers la structure NDIS_OFFLOAD_HANDLE du pilote intermédiaire ou du protocole pour la connexion TCP sur laquelle l’indication est effectuée. Le protocole ou le pilote intermédiaire a fourni ce pointeur en tant que paramètre d’entrée à la fonction NdisInitiateOffload lors du déchargement de la connexion.

[in] EventType

L’événement indiqué comme l’une des valeurs de TCP_OFFLOAD_EVENT_TYPE suivantes :

TcpIndicateDisconnect

Indique que l’hôte distant a lancé une déconnexion normale en envoyant un segment FIN sur la connexion.

TcpIndicateRetrieve

Indique que la cible de déchargement demande à la pile hôte de terminer le déchargement d’une connexion TCP.

TcpIndicateAbort

Indique que l’hôte distant a lancé une déconnexion abandonnée en envoyant un segment RST acceptable sur la connexion.

TcpIndicateSendBacklogChange

Indique une modification de la taille de backlog d’envoi préférée.

[in] EventSpecificInformation

Spécifie des informations supplémentaires sur l’événement indiqué comme suit :

TcpIndicateDisconnect

Pas significatif.

TcpIndicateRetrieve

Indique la raison de la demande de chargement sous la forme d’une valeur TCP_UPLOAD_REASON. Pour plus d’informations, consultez NdisTcpOffloadEventHandler.

TcpIndicateAbort

Pas significatif.

TcpIndicateSendBacklogChange

Spécifie le nombre optimal d’octets d’envoi de données que la pile hôte doit avoir en suspens au niveau de la cible de déchargement afin d’obtenir le meilleur débit de données.

Valeur de retour

Aucun

Remarques

Pour propager l’indication au pilote ou à la pile hôte excessive, le pilote intermédiaire appelle la fonction NdisTcpOffloadEventHandler. Le pilote intermédiaire transmet les paramètres suivants au
fonction NdisTcpOffloadEventHandler :

  • Le NdisOffloadHandle que la cible de déchargement stockée dans son contexte 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.
  • EventType que NDIS a passé à la fonction ProtocolTcpOffloadEvent du pilote intermédiaire.
  • EventSpecificInformation que NDIS a passé à la fonction protocolTcpOffloadEvent du pilote intermédiaire.

Exigences

Exigence Valeur
plateforme cible Windows
d’en-tête ndischimney.h (include Ndischimney.h)

Voir aussi

NdisTcpOffloadEventHandler