Funzione NdisOffloadTcpSend (ndischimney.h)

Articolo
02/29/2024

[La funzionalità di offload del camino TCP è deprecata e non deve essere usata.]

Un driver di protocollo o un driver intermedio chiama la funzione NdisOffloadTcpSend per trasmettere i dati in una connessione TCP scaricata.

Sintassi

NDIS_STATUS NdisOffloadTcpSend(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList
);

Parametri

[in] NdisOffloadHandle

Handle a una struttura NDIS_OFFLOAD_HANDLE nel contesto del chiamante per la connessione TCP disattivata. Per ulteriori informazioni, vedere Riferimento allo stato disattivato tramite un driver intermedio.

[in] NetBufferList

Puntatore a una struttura NET_BUFFER_LIST . Questa struttura può essere una struttura autonoma o la prima struttura in un elenco collegato di strutture NET_BUFFER_LIST. Ogni struttura NET_BUFFER_LIST nell'elenco descrive un elenco di strutture NET_BUFFER . Ogni struttura NET_BUFFER nell'elenco punta a una catena di elenchi di descrittori di memoria (MDLs). Gli MDL contengono i dati da trasmettere. Le NET_BUFFER_LIST e le strutture associate sono bloccate in modo che rimangano residenti nella memoria fisica. Tuttavia, non vengono mappati nella memoria di sistema.

Valore restituito

La funzione NdisOffloadTcpSend restituisce sempre NDIS_STATUS_PENDING. L'operazione di invio viene sempre completata in modo asincrono.

Commenti

In risposta a una chiamata alla funzione MiniportTcpOffloadSend , un driver intermedio chiama la funzione NdisOffloadTcpSend per propagare l'operazione di invio al driver intermedio sottostante o alla destinazione di offload sottostante. Per altre informazioni, vedere Propagazione delle operazioni di I/O.

Per la funzione NdisOffloadTcpSend , il driver intermedio passa quanto segue:

NdisOffloadHandle che fa riferimento alla struttura di NDIS_OFFLOAD_HANDLE archiviata nel contesto del driver intermedio per la connessione TCP caricata. Per ulteriori informazioni, vedere Riferimento allo stato disattivato tramite un driver intermedio.
Lo stesso puntatore PNET_BUFFER_LIST che NDIS passa alla funzione MiniportTcpOffloadSend del driver intermedio.

Quando la destinazione di offload o driver sottostante completa successivamente l'operazione di invio chiamando la funzione NdisTcpOffloadSendComplete , NDIS chiama la funzione ProtocolOffloadSendComplete del driver intermedio . Il driver intermedio chiama quindi la funzione NdisTcpOffloadSendComplete per propagare il completamento dell'operazione di invio.