Funzione NdisOffloadTcpReceive (ndischimney.h)

Articolo
08/07/2023

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

Un driver di protocollo o un driver intermedio chiama la funzione NdisOffloadTcpReceive per pubblicare le richieste di ricezione (buffer di ricezione) in una connessione TCP offloaded.

Sintassi

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

Parametri

[in] NdisOffloadHandle

Handle di una struttura NDIS_OFFLOAD_HANDLE nel contesto del chiamante per la connessione TCP offloaded. Per ulteriori informazioni, vedere Riferimento allo stato offloaded 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 . La struttura NET_BUFFER punta a una catena di elenchi di descrittori di memoria (MDLs). Le NET_BUFFER_LIST e le strutture associate sono bloccate in modo che rimangano residenti nella memoria fisica. Tuttavia, non vengono mappati alla memoria di sistema.

Valore restituito

La funzione NdisOffloadTcpReceive restituisce sempre NDIS_STATUS_PENDING. L'operazione di ricezione viene sempre completata in modo asincrono.

Commenti

In risposta a una chiamata alla relativa La funzione MiniportTcpOffloadReceive , un driver intermedio chiama la funzione NdisOffloadTcpReceive per propagare l'operazione di ricezione al driver intermedio sottostante o alla destinazione di offload. Per altre informazioni, vedere Propagazione di operazioni di I/O.

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

Funzione NdisOffloadHandle che fa riferimento alla struttura NDIS_OFFLOAD_HANDLE archiviata nel contesto del driver intermedio per la connessione TCP offloaded. Per ulteriori informazioni, vedere Riferimento allo stato offloaded tramite un driver intermedio.
Lo stesso puntatore PNET_BUFFER_LIST passato NDIS alla funzione MiniportTcpOffloadReceive del driver intermedio.

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