INVALIDATE_OFFLOAD_COMPLETE_HANDLER funzione di callback (ndischimney.h)

Articolo
08/07/2023

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

NDIS chiama la funzione ProtocolInvalidateOffloadComplete di un driver di protocollo o di un driver intermedio per completare un'operazione invalidata avviata in precedenza dal driver chiamando la funzione NdisInvalidateOffload .

Sintassi

INVALIDATE_OFFLOAD_COMPLETE_HANDLER InvalidateOffloadCompleteHandler;

void InvalidateOffloadCompleteHandler(
  [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 invalidato o che è stato tentato di invalidare.

Valore restituito

nessuno

Osservazioni

In risposta alla chiamata di un driver intermedio o di destinazione di offload sottostante a La funzione NdisMInvalidateOffloadComplete , NDIS chiama il protocollo overlying o il driver intermedio
Funzione ProtocolInvalidateOffloadComplete .

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

Dalla struttura NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST passata alla relativa funzione ProtocolInvalidateOffloadComplete , 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 NdisMInvalidateOffloadComplete , il driver intermedio passa un puntatore (il parametro OffloadBlockList ) a questa struttura NDIS_MINIPORT_OFFLOAD_BLOCK_LIST appena costruita.