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 |