W_QUERY_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/26/2024

[Das TCP-Schornsteinauslagerungsfeature ist veraltet und sollte nicht verwendet werden.]

Die MiniportQueryOffload-Funktion fragt zuvor tcp-Schornsteinzustandsobjekte ab.

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 Ablagezielbereich, in dem das Auslagerungsziel Zustandsinformationen zu diesem instance des Adapters verwaltet. Das Auslagerungsziel hat dieses Handle für NDIS bereitgestellt, wenn es aufgerufen hat. NdisMSetMiniportAttributes aus MiniportInitializeEx-Funktion .

[in, out] OffloadBlockList

Ein Zeiger auf eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, die der Stamm einer verknüpften Liste solcher Strukturen sein kann. Diese Strukturen identifizieren den abgefragten ausgeladenen Zustand.

Rückgabewert

Keine

Bemerkungen

Die MiniportQueryOffload-Funktion kann jeden TCP-Schornsteinzustand abfragen, der an das Auslagerungsziel ausgeladen wurde.

Die MiniportQueryOffload-Funktion speichert den OffloadBlockList-Zeiger und gibt dann zurück. Das Auslagerungsziel schließt den Abfragevorgang immer asynchron ab, indem die NdisMQueryOffloadStateComplete-Funktion . Der OffloadBlockList-Zeiger zeigt auf eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur, die entweder eine eigenständige Struktur oder der Stammknoten in einer Auslagerungszustandsstruktur sein kann. Die Zustandsstruktur ist gültig, bis das Auslagerungsziel 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 der OffloadBlockList-Zeiger verweist. In jede dieser Auslagerungszustandsstrukturen schreibt der Miniporttreiber den aktuellen Wert jeder Variablen in der -Struktur.

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

NDIS_STATUS_SUCCESS
Das Auslagerungsziel hat die Zustandsobjekte erfolgreich abgefragt.
NDIS_STATUS_FAILURE
Der Abfragevorgang war nicht erfolgreich. Der Hoststapel beendet die Zustandsobjekte, die nicht abgefragt werden konnten.