W_UPDATE_OFFLOAD_HANDLER funzione di callback (ndischimney.h)

Articolo
02/26/2024

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

La funzione MiniportUpdateOffload aggiorna in precedenza gli oggetti di stato del camino TCP 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

L'handle a un'area di contesto allocata di destinazione di offload 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] 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 aggiornati. 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 il puntatore OffloadBlockList e quindi restituisce. La destinazione di offload completa sempre l'operazione di aggiornamento in modo asincrono chiamando Funzione NdisMUpdateOffloadComplete . 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é qualsiasi struttura di stato di offload associata a loro, sono validi fino a quando il driver miniport chiama il Funzione NdisMUpdateOffloadComplete .

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

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