INITIATE_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 ProtocolInitiateOffloadComplete del driver di protocollo o del driver intermedio per completare un'operazione di offload avviata in precedenza dal driver chiamando la funzione NdisInitiateOffload .

Sintassi

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [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 una struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST che può essere una struttura autonoma o la radice di un elenco collegato di tali strutture. Queste strutture identificano lo stato che è stato scaricato o che è stato tentato di essere disattivato.

Valore restituito

nessuno

Osservazioni

In risposta alla chiamata di un driver intermedio o di destinazione di offload sottostante alla funzione NdisMInitiateOffloadComplete , NDIS chiama la funzione ProtocolInitiateOfflete del protocollo di overlying o intermedio del driver.

Un driver intermedio deve propagare il completamento dell'operazione di offload avviato al driver sopra di esso chiamando NdisMInitiateOffloadComplete. Per altre informazioni, vedere Propagazione del completamento di un'operazione di State-Manipulation.

Dalla struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST passata alla relativa funzione ProtocolInitiateOffloadComplete , il driver intermedio costruisce una struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST .

Per altre informazioni, vedere Riutilizzo di una struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. Quando si chiama la funzione NdisMInitiateOffloadComplete , il driver intermedio passa un puntatore (il parametro OffloadBlockList ) a questa nuova struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST costruita.