W_UPDATE_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/29/2024

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

Die MiniportUpdateOffload-Funktion aktualisiert zuvor ausgeladene TCP-Schornsteinzustandsobjekte.

Syntax

W_UPDATE_OFFLOAD_HANDLER WUpdateOffloadHandler;

void WUpdateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN PNDIS_MINIPORT_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] MiniportAdapterContext

Das Handle zu einem vom Ziel zugeordneten Kontextbereich, 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] 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 die ausgeladenen Zustandsobjekte, die aktualisiert werden. Nur zwischengespeicherte Variablen werden aktualisiert.

Rückgabewert

Keine

Bemerkungen

Nur zwischengespeicherte Variablen werden aktualisiert.

Die MiniportUpdateOffload-Funktion speichert das MiniportAdapterContext-Handle und den OffloadBlockList-Zeiger und gibt dann zurück. Das Auslagerungsziel schließt den Updatevorgang immer asynchron ab, indem die NdisMUpdateOffloadComplete-Funktion . Der OffloadBlockList-Zeiger verweist auf eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur, die entweder eine eigenständige Struktur oder die Stammblockliste in einer Offload-Zustandsstruktur sein kann, die mehrere NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Strukturen enthält. Solche Blocklisten sowie alle ihnen zugeordneten Offload-Zustandsstrukturen sind gültig, bis der Miniporttreiber die NdisMUpdateOffloadComplete-Funktion .

Bevor die MiniportUpdateOffload-Funktion zurückgegeben wird, verwendet das Auslagerungsziel die an die MiniportUpdateOffload-Funktion übergebene Offload-Zustandsstruktur, um den ausgeladenen Zustand zu aktualisieren:

Das Auslagerungsziel kopiert die Variablenwerte aus allen Zustandsstrukturen in der Struktur in die entsprechenden ausgeladenen Zustandsobjekte. Nur CACHED-Variablen werden aktualisiert.
Die Struktur weist möglicherweise darauf hin, dass Pfad-zu-Nachbar-Links aktualisiert werden müssen. Weitere Informationen finden Sie unter Verknüpfen von Pfadzustandsobjekten mit einem neuen Nachbarstatusobjekt. In diesem Fall muss das Auslagerungsziel seine interne Darstellung des ausgeladenen Zustands aktualisieren, um die aktualisierten Links widerzuspiegeln.