TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER funzione di callback (ndischimney.h)

Articolo
08/07/2023

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

NDIS chiama la funzione ProtocolTcpOffloadComplete del driver di protocollo o del driver intermedio per completare un'operazione di disconnessione avviata in precedenza chiamando il driver Funzione NdisOffloadTcpDisconnect .

Sintassi

TCP_OFFLOAD_DISCONNECT_COMPLETE_HANDLER TcpOffloadDisconnectCompleteHandler;

void TcpOffloadDisconnectCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNET_BUFFER_LIST NetBufferList
)
{...}

Parametri

[in] ProtocolBindingContext

Handle per un'area di contesto allocata dal driver del protocollo. Il driver gestisce le informazioni relative al contesto di associazione in questa area di contesto. Il driver ha fornito questo handle a NDIS quando il driver ha chiamato la funzione NdisOpenAdapterEx .

[in] NetBufferList

Quando non NULL, un puntatore a una singola struttura NET_BUFFER_LIST . Il driver ha fornito questo puntatore come parametro di input in una chiamata precedente all'oggetto Funzione NdisOffloadTcpDisconnect .

Valore restituito

nessuno

Osservazioni

In risposta alla chiamata di destinazione o offload di un driver sottostante all'oggetto La funzione NdisTcpOffloadDisconnectComplete , NDIS chiama la funzione protocollo overlying protocol driver o protocolTcpOffloadDisconnectComplete del driver intermedio .

Per propagare il completamento dell'operazione di disconnessione al driver overlying, il driver intermedio chiama la funzione NdisOffloadTcpDisconnectComplete , passando quanto segue:

Oggetto ProtocolBindingContext, che è un handle che identifica in modo univoco il driver intermedio.
Lo stesso puntatore PNET_BUFFER_LIST che NDIS passa alla funzione ProtocolTcpOffloadDisconnectComplete del driver intermedio .

In risposta, NDIS chiama la funzione ProtocolTcpOffloadDisconnectComplete del driver overlying, passando un handle ProtocolBindingContext e il puntatore PNET_BUFFER_LIST passato dal driver intermedio alla funzione NdisOffloadTcpDisconnectComplete .

Prima di restituire, la funzione ProtocolTcpOffloadDisconnectComplete deve deallocare la memoria per qualsiasi contesto creato per la struttura NET_BUFFER_LIST passata alla funzione.

Si noti che, se un driver intermedio esporta più di un'interfaccia ai protocolli di overlying, deve determinare quale protocollo deve ricevere il completamento della disconnessione. Per effettuare questa determinazione, il driver intermedio usa le informazioni archiviate in NET_BUFFER_LIST_CONTEXT struttura, associata alla struttura NET_BUFFER_LIST.