Funzione NdisOffloadTcpDisconnect (ndischimney.h)

Articolo
08/07/2023

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

Un protocollo o un driver intermedio chiama la funzione NdisOffloadTcpDisconnect per chiudere la metà dell'invio di una connessione TCP offloaded. Inoltre, se la disconnessione da eseguire è una disconnessione normale, il protocollo o il driver intermedio può fornire i dati dell'applicazione che la destinazione di offload sottostante deve trasmettere sulla connessione TCP offloaded prima di inviare un segmento FIN.

Sintassi

NDIS_STATUS NdisOffloadTcpDisconnect(
  [in] IN PNDIS_OFFLOAD_HANDLE NdisOffloadHandle,
  [in] IN PNET_BUFFER_LIST     NetBufferList,
  [in] IN ULONG                Flags
);

Parametri

[in] NdisOffloadHandle

Puntatore a 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 singola struttura NET_BUFFER_LIST . A questa struttura di NET_BUFFER_LIST è associata una sola struttura NET_BUFFER .

[in] Flags

Come uno dei valori seguenti, il tipo di disconnessione da eseguire:

TCP_DISCONNECT_ABORTIVE_CLOSE

Specifica che la destinazione di offload esegue una disconnessione interrotta inviando un segmento RST.

TCP_DISCONNECT_GRACEFUL_CLOSE

Specifica che la destinazione di offload esegue una disconnessione normale inviando un segmento FIN.

Valore restituito

La funzione NdisOffloadTcpDisconnect restituisce sempre NDIS_STATUS_PENDING. L'operazione di disconnessione viene sempre completata in modo asincrono.

Commenti

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

Per la funzione NdisOffloadTcpXxx , 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 MiniportTcpOffloadDisconnect del driver intermedio.
Gli stessi flag passati da NDIS alla funzione MiniportTcpOffloadDisconnect del driver intermedio.

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