TERMINATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/29/2024

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

NDIS ruft die ProtocolTerminateOffloadComplete-Funktion eines Protokoll- oder Zwischentreibers auf, um einen Abladevorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisTerminateOffload-Funktion initiiert hat.

Syntax

TERMINATE_OFFLOAD_COMPLETE_HANDLER TerminateOffloadCompleteHandler;

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

Parameter

[in] ProtocolBindingContext

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

[in] OffloadBlockList

Ein Zeiger auf einen 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 Zustand, der beendet wurde oder der versucht wurde, beendet zu werden.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Auslagerungsziels oder eines zwischengeschalteten Treibers an den NdisMTerminateOffloadComplete-Funktion , NDIS ruft ein Protokoll oder die ProtocolTerminateOffloadComplete-Funktion des Zwischentreibers auf.

Ein Zwischentreiber muss den Abschluss des Auslagerungsvorgangs an den treiber darüber verteilen, indem er NdisMTerminateOffloadComplete aufruft. Weitere Informationen finden Sie unter Weitergabe der Vervollständigung eines State-Manipulation-Vorgangs.

Aus der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST-Struktur, die an ihre ProtocolTerminateOffloadComplete-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 Funktion NdisMTerminateOffloadComplete übergibt der Zwischentreiber einen Zeiger (den Parameter OffloadBlockList ) an diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur.