INVALIDATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
08/07/2023

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

NDIS ruft die ProtocolInvalidateOffloadComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen ungültigen Vorgang abzuschließen, den der Treiber zuvor durch Aufrufen der Funktion NdisInvalidateOffload initiiert hat.

Syntax

INVALIDATE_OFFLOAD_COMPLETE_HANDLER InvalidateOffloadCompleteHandler;

void InvalidateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Parameter

[in] ProtocolBindingContext

Ein Handle zu einem Kontextbereich, der vom Protokolltreiber zugeordnet wird. Der Treiber verwaltet die Kontextinformationen pro Bindung in diesem Kontextbereich. Der Treiber hat dieses Handle für NDIS bereitgestellt, als der Treiber die NdisOpenAdapterEx-Funktion aufgerufen hat.

[in] OffloadBlockList

Ein Zeiger auf eine NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die eine eigenständige Struktur oder der Stamm einer verknüpften Liste solcher Strukturen sein kann. Diese Strukturen identifizieren den Status, der ungültig wurde oder der versucht wurde, ungültig zu werden.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Auslagerungsziels oder eines zwischengeschalteten Treibers an den NdisMInvalidateOffloadComplete-Funktion , NDIS ruft das überlagernde Protokoll oder das des Zwischentreibers auf.
ProtocolInvalidateOffloadComplete-Funktion .

Ein Zwischentreiber muss den Abschluss des Initialauslagerungsvorgangs an den Treiber darüber weitergeben, indem er NdisMInvalidateOffloadComplete aufruft. Weitere Informationen finden Sie unter Weitergabe des Abschlusses eines State-Manipulation Vorgangs.

Aus der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur, die an die ProtocolInvalidateOffloadComplete-Funktion übergeben wurde, erstellt der Zwischentreiber eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur. Weitere Informationen finden Sie unter Wiederverwenden einer NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur. Beim Aufrufen der NdisMInvalidateOffloadComplete-Funktion übergibt der Zwischentreiber einen Zeiger (den OffloadBlockList-Parameter ) auf diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur.