W_TERMINATE_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)
[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]
Die MiniportTerminateOffload--Funktion beendet das Entladen eines oder mehrerer Zustandsobjekte.
Syntax
W_TERMINATE_OFFLOAD_HANDLER WTerminateOffloadHandler;
void WTerminateOffloadHandler(
[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 die entladenen Zustandsobjekte, die beendet werden.
Rückgabewert
Nichts
Bemerkungen
Die MiniportTerminateOffload--Funktion speichert den OffloadBlockList Zeiger und gibt dann zurück. Das Offload-Ziel schließt den Beendigungsvorgang immer asynchron durch Aufrufen der NdisMTerminateOffloadComplete--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 offload-Zustandsstrukturen, die ihnen zugeordnet sind, sind gültig, bis der Miniporttreiber die NdisMTerminateOffloadComplete--Funktion aufruft.
Jede NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur kann unmittelbar im Arbeitsspeicher durch eine delegierte Zustandsstruktur (XXX-_OFFLOAD_STATE_DELEGATED) gefolgt werden. Das Offload-Ziel kopiert delegierte Variablenwerte in die delegierten Zustandsstrukturen, die vom Hoststapel bereitgestellt werden.
Der Hoststapel fordert nicht die Beendigung des Offloads einer TCP-Verbindung an, bis beide der folgenden Bedingungen erfüllt sind:
- Alle ausstehenden ungültigen, Abfrage- und Aktualisierungsanforderungen für diese Verbindung wurden abgeschlossen.
- Alle ausstehenden Anrufe zum Empfangen und Trennen von Anrufen wurden zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | ndischimney.h (include Ndischimney.h) |
| IRQL- | Beliebige Ebene |