W_UPDATE_OFFLOAD_HANDLER funzione di callback (ndischimney.h)

Articolo
02/07/2025

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

La funzione MiniportUpdateOffload aggiorna gli oggetti di stato del camino TCP precedentemente caricati.

Sintassi

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parametri

[in] MiniportAdapterContext

Handle per un'area di contesto allocata dalla destinazione di offload in cui la destinazione di offload mantiene le informazioni sullo stato relative a questa istanza dell'adattatore. La destinazione di offload ha fornito questo handle a NDIS quando ha chiamato NdisMSetMiniportAttributes dal relativo funzione miniportInitializeEx.

[in] 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 offloaded da aggiornare. Vengono aggiornate solo le variabili memorizzate nella cache.

Valore restituito

Nessuno

Osservazioni

Vengono aggiornate solo le variabili memorizzate nella cache.

La funzione MiniportUpdateOffload archivia l'handle MiniportAdapterContext e l'OffloadBlockList puntatore e quindi restituisce. La destinazione di offload completa sempre l'operazione di aggiornamento in modo asincrono chiamando funzione NdisMUpdateOffloadComplete. L'OffloadBlockList puntatore 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 di offload che contiene più strutture NDIS_MINIPORT_OFFLOAD_BLOCK_LIST. Tali elenchi di blocchi, nonché qualsiasi strutture di stato di offload associate, sono valide fino a quando il driver miniport non chiama funzione NdisMUpdateOffloadComplete.

Prima che venga restituita la funzione di miniportUpdateOffload, la destinazione di offload usa l'albero dello stato offload passato alla funzione MiniportUpdateOffload per aggiornare lo stato offloaded:

La destinazione di offload copia i valori delle variabili da qualsiasi struttura di stato nell'albero nell'oggetto oggetti di stato offloaded corrispondenti. Vengono aggiornate solo le variabili CACHED.
L'albero potrebbe indicare che i collegamenti da percorso a vicino devono essere aggiornati. Per altre informazioni, vedere Collegamento di oggetti stato del percorso a un nuovo oggetto Stato adiacente. In questo caso, la destinazione di offload deve aggiornare la relativa rappresentazione interna dello stato offloaded per riflettere i collegamenti aggiornati.