Condividi tramite

TCP_OFFLOAD_EVENT_HANDLER funzione di callback (ndischimney.h)

  • Articolo

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

NDIS chiama la funzione ProtocolIndicateOffloadE vent di un driver di protocollo o di un driver intermedio per pubblicare un'indicazione che è stata avviata dalla chiamata di un driver o di offload di un driver sottostante alla funzione NdisTcpOffloadEventHandler.

Sintassi

TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;

void TcpOffloadEventHandler(
  [in] IN PVOID OffloadContext,
  [in] IN ULONG EventType,
  [in] IN ULONG EventSpecificInformation
)
{...}

Parametri

[in] OffloadContext

Puntatore alla struttura di NDIS_OFFLOAD_HANDLE del protocollo o del driver intermedio per la connessione TCP in cui viene effettuata l'indicazione. Il protocollo o il driver intermedio ha fornito questo puntatore come parametro di input alla funzione NdisInitiateOffload durante l'offload della connessione.

[in] EventType

Evento indicato come uno dei valori di TCP_OFFLOAD_EVENT_TYPE seguenti:

TcpIndicateDisconnect

Indica che l'host remoto ha avviato una disconnessione normale inviando un segmento FIN sulla connessione.

TcpIndicateRetrieve

Indica che la destinazione di offload richiede allo stack host di terminare l'offload di una connessione TCP.

TcpIndicateAbort

Indica che l'host remoto ha avviato una disconnessione interrotta inviando un segmento RST accettabile sulla connessione.

TcpIndicateSendBacklogChange

Indica una modifica delle dimensioni del backlog di invio preferite.

[in] EventSpecificInformation

Specifica informazioni aggiuntive sull'evento indicato di seguito:

TcpIndicateDisconnect

Non significativo.

TcpIndicateRetrieve

Indica il motivo della richiesta di caricamento come valore TCP_UPLOAD_REASON. Per altre informazioni, vedere NdisTcpOffloadEventHandler.

TcpIndicateAbort

Non significativo.

TcpIndicateSendBacklogChange

Specifica il numero ottimale di byte di dati di invio che lo stack host deve avere in sospeso nella destinazione di offload per ottenere la migliore velocità effettiva dei dati.

Valore restituito

Nessuno

Osservazioni

Per propagare l'indicazione allo stack di driver o host overlying, il driver intermedio chiama la funzione NdisTcpOffloadEventHandler. Il driver intermedio passa i parametri seguenti a
funzione NdisTcpOffloadEventHandler:

  • Il NdisOffloadHandle che la destinazione di offload archiviata nel contesto per la connessione TCP offloaded. Per altre informazioni, vedere riferimento allo stato offloaded tramite un driver intermedio.
  • EventType passato NDIS alla funzione ProtocolTcpOffloadEvent del driver intermedio.
  • Il EventSpecificInformation passato NDIS alla funzione di ProtocolTcpOffloadEvent del driver intermedio.

Fabbisogno

Requisito Valore
piattaforma di destinazione Finestre
intestazione ndischimney.h (include Ndischimney.h)

Vedere anche

NdisTcpOffloadEventHandler