INITIATE_OFFLOAD_COMPLETE_HANDLER fonction de rappel (ndischimney.h)

Article
02/29/2024

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

NDIS appelle la fonction ProtocolInitiateOffloadComplete d’un pilote de protocole ou d’un pilote intermédiaire pour effectuer une opération de déchargement que le pilote a précédemment lancée en appelant la fonction NdisInitiateOffload .

Syntaxe

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Paramètres

[in] ProtocolBindingContext

Handle à une zone de contexte allouée par le pilote de protocole. Le pilote conserve les informations de contexte par liaison dans cette zone de contexte. Le pilote a fourni ce handle à NDIS quand le pilote a appelé la fonction NdisOpenAdapterEx .

[in] OffloadBlockList

Pointeur vers une structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST qui peut être une structure autonome ou la racine d’une liste liée de ces structures. Ces structures identifient l’état qui a été déchargé ou qui a été tenté de l’être.

Valeur de retour

None

Remarques

En réponse à l’appel d’une cible de déchargement sous-jacente ou d’un pilote intermédiaire à la fonction NdisMInitiateOffloadComplete , NDIS appelle la fonction ProtocolInitiateOffloadComplete du protocole de suralimentation ou du pilote intermédiaire.

Un pilote intermédiaire doit propager l’achèvement de l’opération de déchargement initial au pilote situé au-dessus en appelant NdisMInitiateOffloadComplete. Pour plus d’informations, consultez Propagation de l’achèvement d’une opération de State-Manipulation.

À partir de la structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST qui a été passée à sa fonction ProtocolInitiateOffloadComplete , le pilote intermédiaire construit une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST .

Pour plus d’informations, consultez Réutilisation d’une structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Lors de l’appel de la fonction NdisMInitiateOffloadComplete , le pilote intermédiaire transmet un pointeur (le paramètre OffloadBlockList ) à cette structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST nouvellement construite.