Fonction NdisInitiateOffload (ndischimney.h)

Article
02/26/2024

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

Un protocole ou un pilote intermédiaire appelle la fonction NdisInitiateOffload pour décharger les objets d’état de cheminée TCP.

Syntaxe

void NdisInitiateOffload(
  [in]      IN NDIS_HANDLE                           NdisBindingHandle,
  [in, out] IN OUT PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
);

Paramètres

[in] NdisBindingHandle

Handle fourni par NDIS au paramètre NdisBindingHandle de NdisOpenAdapterEx. Ce handle identifie la liaison entre l’appelant et le pilote intermédiaire sous-jacent ou la cible de déchargement.

[in, out] OffloadBlockList

Pointeur vers un NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST structure qui peut être une structure autonome ou la racine d’une liste liée de telles structures. Ces structures identifient l’état en cours de déchargement.

Valeur de retour

None

Remarques

Un pilote intermédiaire appelle la fonction NdisInitiateOffload pour propager une opération de déchargement lancée par la pile hôte. Pour plus d’informations, consultez Propagation des opérations State-Manipulation.

Dans la liste NDIS_MINIPORT_OFFLOAD_BLOCK_LIST structure passée à sa fonction MiniportInitiateOffload , le pilote intermédiaire construit une structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Pour plus d’informations, consultez Réutilisation d’une structure NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Le pilote intermédiaire transmet un pointeur (le paramètre OffloadBlockList ) vers cette structure NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST lors de l’appel de la fonction NdisInitiateOffload .