UPDATE_OFFLOAD_COMPLETE_HANDLER funzione di callback (ndischimney.h)

Articolo
02/29/2024

[La funzionalità di offload del camino TCP è deprecata e non deve essere usata.]

NDIS chiama la funzione ProtocolUpdateOffloadComplete di un driver di protocollo o di un driver intermedio per completare un'operazione di offload di aggiornamento avviata in precedenza dal driver chiamando la funzione NdisUpdateOffload .

Sintassi

UPDATE_OFFLOAD_COMPLETE_HANDLER UpdateOffloadCompleteHandler;

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

Parametri

[in] ProtocolBindingContext

Handle per un'area di contesto allocata dal driver del protocollo. Il driver gestisce le informazioni sul contesto per associazione in questa area di contesto. Il driver ha fornito questo handle a NDIS quando il driver ha chiamato la funzione NdisOpenAdapterEx

[in] OffloadBlockList

Puntatore a un oggetto NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST struttura che può essere una struttura autonoma o la radice di un elenco collegato di tali strutture. Queste strutture identificano lo stato aggiornato o che è stato tentato di aggiornare.

Valore restituito

nessuno

Osservazioni

In risposta alla chiamata di un driver intermedio o di destinazione di offload sottostante a La funzione NdisMUpdateOffloadComplete , NDIS chiama un protocollo o la funzione ProtocolUpdateOffloadComplete del driver intermedio.

Un driver intermedio deve propagare il completamento dell'operazione di offload di aggiornamento al driver precedente chiamando NdisMUpdateOffloadComplete. Per ulteriori informazioni, vedere Propagazione del completamento di un'operazione State-Manipulation.

Dalla struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST passata alla relativa funzione ProtocolUpdateOffloadComplete , il driver intermedio costruisce un oggetto NDIS_MINIPORT_OFFLOAD_BLOCK_LIST struttura. Per altre informazioni, vedere Riutilizzo di una struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Quando si chiama la funzione NdisMUpdateOffloadComplete , il driver intermedio passa un puntatore (il parametro OffloadBlockList ) a questa struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST appena costruita.