funzione di callback TCP_OFFLOAD_EVENT_HANDLER (ndischimney.h)

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

NDIS chiama la funzione ProtocolIndicateOffloadEvent di un driver di protocollo o di un driver intermedio per pubblicare un'indicazione che è stata avviata dalla chiamata di un driver o dall'offload della destinazione 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

L'evento indicato come uno dei valori 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 ulteriori informazioni, vedere NdisTcpOffloadEventHandler.

TcpIndicateAbort

Non significativo.

TcpIndicateSendBacklogChange

Specifica il numero ottimale di byte di dati inviati che lo stack host deve avere in sospeso nella destinazione di offload per ottenere la massima 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 :

• NdisOffloadHandle archiviato nella destinazione di offload nel contesto per la connessione TCP offloaded. Per ulteriori informazioni, vedere Riferimento allo stato offloaded tramite un driver intermedio.
• EventType passato NDIS alla funzione ProtocolTcpOffloadEvent del driver intermedio.
• EventSpecificInformation che NDIS ha passato alla funzione ProtocolTcpOffloadEvent del driver intermedio.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	ndischimney.h (include Ndischimney.h)

Vedi anche

NdisTcpOffloadEventHandler