UPDATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
08/07/2023

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

NDIS ruft die ProtocolUpdateOffloadComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Updateauslagerungsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der Funktion NdisUpdateOffload initiiert hat.

Syntax

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

void UpdateOffloadCompleteHandler(
  [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, als der Treiber die Funktion NdisOpenAdapterEx 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 Status, der aktualisiert wurde oder der versucht wurde, aktualisiert zu werden.

Rückgabewert

Keine

Bemerkungen

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

Ein Zwischentreiber muss den Abschluss des Updateauslagerungsvorgangs an den treiber darüber verteilen, indem er NdisMUpdateOffloadComplete 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 ProtocolUpdateOffloadComplete-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 NdisMUpdateOffloadComplete übergibt der Zwischentreiber einen Zeiger (den Parameter OffloadBlockList ) an diese neu erstellte NDIS_MINIPORT_OFFLOAD_BLOCK_LIST-Struktur.