W_INVALIDATE_OFFLOAD_HANDLER funzione di callback (ndischimney.h)
[La funzionalità offload del camino TCP è deprecata e non deve essere usata.]
La funzione miniportInvalidateOffload invalida gli oggetti stato tcp camino precedentemente scaricati.
Sintassi
W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;
void WInvalidateOffloadHandler(
[in] IN NDIS_HANDLE MiniportAdapterContext,
[in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}
Parametri
[in] MiniportAdapterContext
Handle in un'area di contesto allocata di destinazione 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 l'oggetto stato offloaded che viene invalidato.
Valore restituito
Nessuno
Osservazioni
La funzione miniportInvalidateOffload archivia il puntatore offloadBlockList e quindi restituisce. La destinazione di offload completa sempre l'operazione invalidata in modo asincrono chiamando NdisMInvalidateOffloadComplete.
L'albero passato alla funzione MiniportInvalidateOffload contiene solo NDIS_MINIPORT_OFFLOAD_BLOCK_LIST strutture. L'albero non contiene strutture di stato di offload . Ciò significa che non esistono strutture di questo tipo che seguono le strutture NDIS_MINIPORT_OFFLOAD_BLOCK_LIST in memoria.
Le strutture NDIS_MINIPORT_OFFLOAD_BLOCK_LIST nell'albero indicano che l'oggetto stato deve essere invalidato. Un non NULL *MiniportOffloadContext membro punta a una posizione di memoria contenente un valore PVOID fornito dalla destinazione di offload quando l'oggetto stato è stato scaricato. Per altre informazioni, vedere Archiviazione e riferimento allo stato offloaded. Questo valore PVOID fa riferimento al contesto di offload miniport in cui la destinazione di offload archivia l'oggetto stato da invalidare.
Per informazioni sul trattamento di una destinazione di offload di oggetti di stato invalidati, vedere Trattamento di oggetti di stato invalidati.
Infine, lo stack host terminerà l'offload dell'oggetto di stato invalidato. Tuttavia, fino a quel momento, la destinazione di offload è proprietaria dell'oggetto stato invalidato. La destinazione di offload non deve liberare le risorse per l'oggetto stato invalidato fino a quando lo stack host non ha terminato l'offload di tale oggetto di stato. La destinazione di offload non deve utilizzare l'oggetto di stato invalidato o le connessioni TCP che dipendono da tale oggetto di stato per l'invio di dati.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione | ndischimney.h (include Ndischimney.h) |
| IRQL | Qualsiasi livello |