INITIATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/07/2025

[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]

NDIS ruft die ProtocolInitiateOffloadComplete- funktion eines Protokolltreibers oder zwischentreibers auf, um einen offload-Vorgang abzuschließen, den der Treiber zuvor durch Aufrufen der funktion NdisInitiateOffload initiiert hat.

Syntax

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

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

Parameter

[in] ProtocolBindingContext

Ein Handle zu einem Kontextbereich, der vom Protokolltreiber zugewiesen wird. Der Treiber behält die Informationen zu bindungskontextbezogenen Informationen in diesem Kontextbereich bei. Der Treiber hat diesen Handle an NDIS übergeben, wenn 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 Zustand, der entladen wurde oder der versucht wurde, entladen zu werden.

Rückgabewert

Nichts

Bemerkungen

Als Reaktion auf den Aufruf eines zugrunde liegenden Offloadziels oder eines Zwischentreibers an den NdisMInitiateOffloadComplete--Funktion ruft NDIS die ProtocolInitiateOffloadComplete-Funktion des überlagernden Protokolls oder Zwischentreibers auf.

Ein Zwischentreiber muss den Abschluss des initiierenden Offloadvorgangs an den darüber liegenden Treiber weitergeben, indem NdisMInitiateOffloadCompleteaufgerufen wird. Weitere Informationen finden Sie unter Verteilen des Abschlusses eines State-Manipulation Operation.

Von der NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Struktur, die an die ProtocolInitiateOffloadComplete--Funktion übergeben wurde, erstellt der Zwischentreiber eine NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur.

Weitere Informationen finden Sie unter Reusing an NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST Structure. Beim Aufrufen der NdisMInitiateOffloadComplete-Funktion übergibt der Zwischentreiber einen Zeiger (der OffloadBlockList Parameter) an diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST Struktur.