Funzione NdisOffloadTcpReceive (ndischimney.h)

Articolo
02/07/2025

[La funzionalità 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 altre 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 di NdisOffloadTcpReceive restituisce sempre NDIS_STATUS_PENDING. L'operazione di ricezione viene sempre completata in modo asincrono.

Osservazioni

In risposta a una chiamata alla relativa 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 altre 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 o la destinazione di offload sottostante completa successivamente l'operazione di ricezione chiamando la funzione NdisTcpOffloadReceiveComplete, NDIS chiama la funzione ProtocolOffloadReceiveComplet e del driver intermedio. Il driver intermedio chiama quindi la funzione NdisTcpOffloadReceiveComplete per propagare il completamento dell'operazione di inoltro.