INITIATE_OFFLOAD_COMPLETE_HANDLER Rückruffunktion (ndischimney.h)

Artikel
02/26/2024

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

NDIS ruft die ProtocolInitiateOffloadComplete-Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Auslagerungsvorgang abzuschließen, den der Treiber zuvor durch Aufrufen der NdisInitiateOffload-Funktion 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 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 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 ausgeladen wurde oder der versucht wurde, entladen zu werden.

Rückgabewert

Keine

Bemerkungen

Als Reaktion auf den Aufruf der NdisMInitiateOffloadComplete-Funktion eines zugrunde liegenden Auslagerungsziels oder zwischengeschalteten Treibers ruft NDIS die ProtocolInitiateOffloadComplete-Funktion des überlagernden Protokolls oder zwischengeschalteten Treibers auf.

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