W_TERMINATE_OFFLOAD_HANDLER funzione di callback (ndischimney.h)

Articolo
02/29/2024

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

La funzione MiniportTerminateOffload termina il caricamento di uno o più oggetti di stato.

Sintassi

W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;

void WTerminateOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parametri

[in] MiniportAdapterContext

L'handle a un'area di contesto allocata di offload-target in cui la destinazione di offload gestisce le informazioni sullo stato su questa istanza dell'adapter. La destinazione di offload ha fornito questo handle a NDIS quando viene chiamato NdisMSetMiniportAttributes dal relativo Funzione MiniportInitializeEx .

[in, out] OffloadBlockList

Puntatore a un oggetto NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struttura, che può essere la radice di un elenco collegato di tali strutture. Queste strutture identificano gli oggetti di stato caricati che vengono terminati.

Valore restituito

nessuno

Osservazioni

La funzione MiniportTerminateOffload archivia il puntatore OffloadBlockList e quindi restituisce. La destinazione di offload completa sempre l'operazione di termina in modo asincrono chiamando l'oggetto Funzione NdisMTerminateOffloadComplete .

Il puntatore OffloadBlockList punta a una struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST che può essere una struttura autonoma o l'elenco di blocchi radice in un albero dello stato offload contenente più strutture NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Tali elenchi di blocchi, nonché le strutture di stato offload associate a tali strutture, sono valide fino a quando il driver miniport chiama la funzione NdisMTerminateOffloadComplete .

Ogni struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST può essere immediatamente seguita in memoria da una struttura dello stato delegato (XXX_OFFLOAD_STATE_DELEGATED). La destinazione offload copia i valori delle variabili delegate nelle strutture di stato delegate fornite dallo stack host.

Lo stack host non richiederà la terminazione dell'offload di una connessione TCP fino a quando non vengono soddisfatte entrambe le condizioni seguenti:

Tutte le richieste di aggiornamento, query e invalidate in sospeso relative a tale connessione sono state completate.
Tutte le chiamate di ricezione e disconnessione in sospeso sono state restituite.