W_QUERY_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)

[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]

Die MiniportQueryOffload- Funktionsabfragen wurden zuvor deaktivierte TCP-Schornsteinzustandsobjekte.

Syntax

W_QUERY_OFFLOAD_HANDLER WQueryOffloadHandler;

void WQueryOffloadHandler(
  [in]      IN NDIS_HANDLE MiniportAdapterContext,
  [in, out] IN OUT PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] MiniportAdapterContext

Das Handle für einen kontextbezogenen Offload-Zielbereich, in dem das Offloadziel Zustandsinformationen zu dieser Instanz des Adapters verwaltet. Das Offload-Ziel hat dieses Handle beim Aufrufen an NDIS bereitgestellt. von NdisMSetMiniportAttributes MiniportInitializeEx Funktion.

[in, out] OffloadBlockList

Ein Zeiger auf einen NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, die der Stamm einer verknüpften Liste solcher Strukturen sein kann. Diese Strukturen identifizieren den entladenen Zustand, der abgefragt wird.

Rückgabewert

Nichts

Bemerkungen

Die MiniportQueryOffload-Funktion kann jeden TCP-Schornsteinzustand abfragen, der in das Offload-Ziel geladen wurde.

Die MiniportQueryOffload-Funktion speichert den OffloadBlockList Zeiger und gibt dann zurück. Das Offloadziel schließt den Abfragevorgang immer asynchron durch Aufrufen des NdisMQueryOffloadStateComplete Funktion. Der OffloadBlockList Zeiger verweist auf einen NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, die entweder eine eigenständige Struktur oder der Stammknoten in einer Offload-Zustandsstruktursein kann. Die Statusstruktur ist gültig, bis das Offload-Ziel die NdisMQueryOffloadStateComplete-Funktion aufruft.

Nach der Rückgabe von der MiniportQueryOffload--Funktion füllt der Miniporttreiber die Offload-Zustandsstruktur aus, die jeder NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur in der Zustandsstruktur zugeordnet ist, auf die vom OffloadBlockList Zeiger verwiesen wird. Für jede dieser Offload-Zustandsstrukturen schreibt der Miniporttreiber den aktuellen Wert jeder Variablen in der Struktur.

Vor dem Aufrufen der NdisMQueryOffloadStateComplete--Funktion muss das Offloadziel einen der folgenden NDIS_STATUS Werte in das Status-element jeder NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur in der Zustandsstruktur schreiben:

• NDIS_STATUS_SUCCESS

  Das Offloadziel hat die Statusobjekte erfolgreich abgefragt.

• NDIS_STATUS_FAILURE

  Der Abfragevorgang wurde nicht erfolgreich ausgeführt. Der Hoststapel beendet die Zustandsobjekte, die nicht abgefragt werden konnten.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	ndischimney.h (include Ndischimney.h)
IRQL-	Beliebige Ebene

Siehe auch

MiniportInitializeEx-

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMQueryOffloadStateComplete-

NdisMSetMiniportAttributes