TERMINATE_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 una funzione ProtocolTerminateOffloadComplete del protocollo o del driver intermedio per completare un'operazione di offload terminata avviata in precedenza chiamando la funzione NdisTerminateOffload .

Sintassi

TERMINATE_OFFLOAD_COMPLETE_HANDLER TerminateOffloadCompleteHandler;

void TerminateOffloadCompleteHandler(
  [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 relative al contesto di 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 terminato o che è stato tentato di terminare.

Valore restituito

nessuno

Osservazioni

In risposta alla chiamata al driver intermedio o alla destinazione di offload sottostante La funzione NdisMTerminateOffloadComplete, NDIS chiama una funzione ProtocolTerminateOffloadComplete del protocollo o del driver intermedio.

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

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