W_INVALIDATE_OFFLOAD_HANDLER Rückruffunktion (ndischimney.h)

  • Artikel

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

Die MiniportInvalidateOffload-Funktion ungültigt zuvor entladene TCP-Schornsteinzustandsobjekte.

Syntax

W_INVALIDATE_OFFLOAD_HANDLER WInvalidateOffloadHandler;

void WInvalidateOffloadHandler(
  [in] IN NDIS_HANDLE MiniportAdapterContext,
  [in] IN 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] 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 das entladene Zustandsobjekt, das ungültig wird.

Rückgabewert

Keine

Bemerkungen

Die MiniportInvalidateOffload-Funktion speichert den OffloadBlockList-Zeiger und gibt dann zurück. Das Auslagerungsziel schließt den Invalidate-Vorgang immer asynchron ab, indem es aufruft. NdisMInvalidateOffloadComplete.

Die an die Funktion MiniportInvalidateOffload übergebene Struktur enthält nur NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Strukturen. Die Struktur enthält keine Auslagerungszustandsstrukturen. Das heißt, es gibt keine solchen Strukturen, die den NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Strukturen im Arbeitsspeicher folgen.

Die NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Strukturen in der Struktur geben an, dass das Zustandsobjekt ungültig wird. Ein *MiniportOffloadContext-Element ohne NULL verweist auf einen Speicherspeicherort, der einen PVOID-Wert enthält, der vom Auslagerungsziel beim Entladen des Zustandsobjekts bereitgestellt wurde. Weitere Informationen finden Sie unter Speichern und Verweisen auf den ausgeladenen Zustand. Dieser PVOID-Wert verweist auf den Miniport offload-Kontext, in dem das Auslagerungsziel das Zustandsobjekt speichert, das ungültig werden soll.

Informationen zur Behandlung ungültiger Zustandsobjekte durch ein Auslagerungsziel finden Sie unter Behandlung ungültiger Zustandsobjekte.

Schließlich beendet der Hoststapel die Auslagerung des ungültigen Zustandsobjekts. Bis zu diesem Zeitpunkt besitzt das Auslagerungsziel jedoch das ungültige Zustandsobjekt. Das Auslagerungsziel darf die Ressourcen für das ungültige Zustandsobjekt erst freigeben, wenn der Hoststapel die Auslagerung dieses Zustandsobjekts beendet hat. Das Auslagerungsziel darf zum Senden von Daten weder das ungültige Zustandsobjekt noch TCP-Verbindungen verwenden, die von diesem Zustandsobjekt abhängig sind.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile ndischimney.h (include Ndischimney.h)
IRQL Beliebige Ebene

Weitere Informationen

MiniportInitializeEx

NDIS_MINIPORT_OFFLOAD_BLOCK_LIST NdisMInvalidateOffloadComplete

NdisMSetMiniportAttributes