Funzione NdisOffloadTcpForward (ndischimney.h)

Articolo
03/05/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 NdisOffloadTcpForward per inoltrare segmenti TCP ricevuti non riconosciuti a un driver sottostante o a una destinazione di offload.

Sintassi

NDIS_STATUS NdisOffloadTcpForward(
  [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 una struttura NET_BUFFER . Ogni struttura NET_BUFFER punta a una catena di elenchi di descrittori di memoria (MDLs). Gli MDLs associati a una struttura NET_BUFFER contengono uno e un solo segmento TCP inoltrato alla destinazione di offload. Il primo byte del primo MDL è il primo byte dell'intestazione TCP. 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 NdisOffloadTcpForward restituisce sempre NDIS_STATUS_PENDING. L'operazione di inoltro viene sempre completata in modo asincrono.

Commenti

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

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

Funzione 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 passato al driver intermedio Funzione MiniportTcpOffloadForward .

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