W_QUERY_OFFLOAD_HANDLER funzione di callback (ndischimney.h)

  • Articolo

[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

Vedi anche

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete

NdisMSetMiniportAttributes