W_QUERY_OFFLOAD_HANDLER funzione di callback (ndischimney.h)
[La funzionalità di offload del camino TCP è deprecata e non deve essere usata.]
La funzione MiniportQueryOffload esegue query sullo stato del camino TCP caricato in precedenza.
Sintassi
W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;
void WQueryOffloadHandler(
[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 lo stato di offload sottoposto a query.
Valore restituito
nessuno
Osservazioni
La funzione MiniportQueryOffload può eseguire query su qualsiasi stato del camino TCP disattivato nella destinazione di offload.
La funzione MiniportQueryOffload archivia il puntatore OffloadBlockList e quindi restituisce. La destinazione di offload completa sempre l'operazione di query in modo asincrono chiamando Funzione NdisMQueryOffloadStateComplete . Il puntatore OffloadBlockList punta a un NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struttura che può essere una struttura autonoma o il nodo radice in un albero dello stato offload. L'albero dello stato è valido finché la destinazione offload chiama la funzione NdisMQueryOffloadStateComplete .
Dopo aver restituito dalla funzione MiniportQueryOffload , il driver miniport riempie la struttura dello stato offload associata a ogni struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST nell'albero dello stato puntato dal puntatore OffloadBlockList . Per ognuna di queste strutture di stato di offload, il driver miniport scrive il valore corrente di ogni variabile nella struttura.
Prima di chiamare la funzione NdisMQueryOffloadStateComplete , la destinazione offload deve scrivere uno dei valori di NDIS_STATUS seguenti al membro Status di ogni struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST nell'albero dello stato:
-
NDIS_STATUS_SUCCESS
La destinazione di offload ha eseguito correttamente una query sugli oggetti di stato.
-
NDIS_STATUS_FAILURE
L'operazione di query non ha avuto esito positivo. Lo stack host termina gli oggetti di stato che non possono essere sottoposti a query.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ndischimney.h (includere Ndischimney.h) |
| IRQL | Qualsiasi livello |