W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER fonction de rappel (ndischimney.h)

Article
02/26/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 MiniportTcpOffloadReceiveReturn pour renvoyer la propriété des NET_BUFFER_LIST et des structures associées à une cible de déchargement.

Syntaxe

W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;

NDIS_STATUS WTcpOffloadReceiveReturnHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Paramètres

[in] MiniportAdapterContext

Handle vers une zone de contexte allouée de la cible de déchargement dans laquelle la cible de déchargement conserve des informations d’état sur cette instance de l’adaptateur. Le pilote miniport a fourni ce handle à NDIS lorsqu’il a appelé NdisMSetMiniportAttributes à partir de son Fonction MiniportInitializeEx .

[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. La liste liée peut contenir des structures NET_BUFFER_LIST à partir d’un ou plusieurs appels au Fonction NdisTcpOffloadReceiveHandler .

Valeur retournée

La fonction MiniportTcpOffloadReceiveReturn doit toujours réussir. Par conséquent, la fonction MiniportTcpOffloadReceiveReturn doit toujours retourner NDIS_STATUS_SUCCESS.

Remarques

NDIS appelle la fonction MiniportTcpOffloadReceiveReturn pour retourner la propriété des structures NET_BUFFER_LIST et des structures associées que la cible de déchargement a passées dans un ou plusieurs appels précédents à la Fonction NdisTcpOffloadReceiveHandler .

La fonction MiniportTcpOffloadReceiveReturn peut préparer une structure de NET_BUFFER_LIST retournée pour une utilisation dans une indication de réception ultérieure. Bien que la fonction MiniportTcpOffloadReceiveReturn puisse renvoyer les structures NET_BUFFER_LIST à un pool (par exemple, elle peut appeler la fonction NdisFreeNetBufferList ), elle peut être plus efficace pour réutiliser les structures sans les renvoyer au pool.

Notez que le pilote cible de déchargement ne doit pas se décharger et que l’adaptateur cible de déchargement ne doit pas être fermé tant que toutes les mémoires tampons de réception indiquées n’ont pas été retournées.