QUERY_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 ProtocolQueryOffloadComplete di un driver di protocollo o di un driver intermedio per completare un'operazione di offload di query avviata in precedenza dal driver chiamando la funzione NdisQueryOffload .

Sintassi

QUERY_OFFLOAD_COMPLETE_HANDLER QueryOffloadCompleteHandler;

void QueryOffloadCompleteHandler(
  [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 su cui è stata eseguita una query o che è stato tentato di eseguire query.

Valore restituito

nessuno

Osservazioni

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

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

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