W_INVALIDATE_OFFLOAD_HANDLER funzione di callback (ndischimney.h)
[La funzionalità di offload del camino TCP è deprecata e non deve essere usata.]
La funzione MiniportInvalidateOffload invalida gli oggetti di stato tcp caricati in precedenza.
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 gestisce le informazioni sullo stato relative a questa istanza dell'adattatore. La destinazione di offload ha fornito questo handle a NDIS quando viene chiamato NdisMSetMiniportAttributes da 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 membro *MiniportOffloadContext non NULL punta a una posizione di memoria contenente un valore PVOID fornito dalla destinazione di offload quando l'oggetto di stato è stato scaricato. Per altre informazioni, vedere Archiviazione e riferimento allo stato offloaded. Questo valore PVOID fa riferimento al contesto di offload del miniport in cui la destinazione di offload archivia l'oggetto di stato da invalidare.
Per informazioni sul trattamento di una destinazione di offload di oggetti di stato invalidati, vedere Trattamento di oggetti di stato invalidati.
Alla fine, 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 di 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 stato invalidato o le connessioni TCP che dipendono da tale oggetto di stato per l'invio di dati.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ndischimney.h (include Ndischimney.h) |
| IRQL | Qualsiasi livello |