Partager via

TCP_OFFLOAD_EVENT_HANDLER fonction de rappel (ndischimney.h)

  • Article

[La fonctionnalité de déchargement de la 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 d’un pilote intermédiaire pour publier une indication qui a été initiée par l’appel d’un pilote ou d’une cible de déchargement sous-jacent au 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 de NDIS_OFFLOAD_HANDLE du protocole ou du pilote intermédiaire 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

Événement indiqué comme l’une des valeurs 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 de l’hôte d’arrêter le déchargement d’une connexion TCP.

TcpIndicateAbort

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

TcpIndicateSendBacklogChange

Indique une modification de la taille du backlog d’envoi par défaut.

[in] EventSpecificInformation

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

TcpIndicateDisconnect

Non significatif.

TcpIndicateRetrieve

Indique la raison de la demande de chargement en tant que valeur TCP_UPLOAD_REASON. Pour plus d'informations, consultez la rubrique NdisTcpOffloadEventHandler.

TcpIndicateAbort

Non significatif.

TcpIndicateSendBacklogChange

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

Valeur de retour

None

Remarques

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

  • NdisOffloadHandle que la cible de déchargement stockée dans son contexte 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.
  • Type d’événement transmis par NDIS à la fonction ProtocolTcpOffloadEvent du pilote intermédiaire.
  • EventSpecificInformation que NDIS a transmis à la fonction ProtocolTcpOffloadEvent du pilote intermédiaire.

Configuration requise

Condition requise Valeur
Plateforme cible Windows
En-tête ndischimney.h (inclure Ndischimney.h)

Voir aussi

NdisTcpOffloadEventHandler