W_UPDATE_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)
[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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ndischimney.h (include Ndischimney.h) |
| IRQL | Beliebige Ebene |