W_TERMINATE_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)

Artikel
03/01/2024

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

Die MiniportTerminateOffload-Funktion beendet die Auslagerung 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 vom Auslagerungsziel 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, 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

Keine

Bemerkungen

Die MiniportTerminateOffload-Funktion speichert den OffloadBlockList-Zeiger und gibt dann zurück. Das Auslagerungsziel schließt den Beendigungsvorgang immer asynchron ab, indem die 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 Abladezustandsstruktur sein kann, die mehrere NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Strukturen enthält. Solche Blocklisten sowie alle ihnen zugeordneten Auslagerungszustandsstrukturen sind gültig, bis der Miniporttreiber die Funktion NdisMTerminateOffloadComplete aufruft .

Jede NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur kann im Arbeitsspeicher sofort von einer delegierten Zustandsstruktur (XXX_OFFLOAD_STATE_DELEGATED) gefolgt werden. Das Auslagerungsziel kopiert delegierte Variablenwerte in die vom Hoststapel bereitgestellten delegierten Zustandsstrukturen.

Der Hoststapel fordert erst dann die Beendigung der Auslagerung einer TCP-Verbindung an, wenn die beiden folgenden Bedingungen erfüllt sind:

Alle ausstehenden Ungültigungs-, Abfrage- und Aktualisierungsanforderungen in Bezug auf diese Verbindung wurden abgeschlossen.
Alle ausstehenden Empfangs- und Verbindungsanrufe wurden zurückgegeben.