TCP_OFFLOAD_EVENT_HANDLER Rückruffunktion (ndischimney.h)
[Das TCP-Schornstein-Offload-Feature ist veraltet und sollte nicht verwendet werden.]
NDIS ruft die ProtocolIndicateOffloadEvent Funktion eines Protokolltreibers oder Zwischentreibers auf, um einen Hinweis zu posten, der durch den Aufruf eines zugrunde liegenden Treibers oder offload-Ziels an den Aufruf des zugrunde liegenden Treibers initiiert wurde. NdisTcpOffloadEventHandler Funktion.
Syntax
TCP_OFFLOAD_EVENT_HANDLER TcpOffloadEventHandler;
void TcpOffloadEventHandler(
[in] IN PVOID OffloadContext,
[in] IN ULONG EventType,
[in] IN ULONG EventSpecificInformation
)
{...}
Parameter
[in] OffloadContext
Ein Zeiger auf die NDIS_OFFLOAD_HANDLE Struktur des Protokoll- oder Zwischentreibers für die TCP-Verbindung, auf der die Angabe erfolgt. Der Protokoll- oder Zwischentreiber hat diesen Zeiger beim Entladen der Verbindung als Eingabeparameter für die NdisInitiateOffload Funktion bereitgestellt.
[in] EventType
Das Ereignis, das als einer der folgenden TCP_OFFLOAD_EVENT_TYPE Werte angegeben wird:
TcpIndicateDisconnect
Gibt an, dass der Remotehost eine ordnungsgemäße Verbindung initiiert hat, indem ein FIN-Segment an die Verbindung gesendet wird.
TcpIndicateRetrieve
Gibt an, dass das Offload-Ziel den Hoststapel anfordert, die Auslagerung einer TCP-Verbindung zu beenden.
TcpIndicateAbort
Gibt an, dass der Remotehost eine abgebrochene Verbindung initiiert hat, indem ein akzeptables RST-Segment für die Verbindung gesendet wird.
TcpIndicateSendBacklogChange
Gibt eine Änderung der bevorzugten Größe des Sendebackprotokolls an.
[in] EventSpecificInformation
Gibt zusätzliche Informationen zum Ereignis an, das wie folgt angegeben wird:
TcpIndicateDisconnect
Nicht sinnvoll.
TcpIndicateRetrieve
Gibt den Grund für die Uploadanforderung als TCP_UPLOAD_REASON Wert an. Weitere Informationen finden Sie unter NdisTcpOffloadEventHandler.
TcpIndicateAbort
Nicht sinnvoll.
TcpIndicateSendBacklogChange
Gibt die optimale Anzahl von Sendedatenbytes an, die der Hoststapel am Offload-Ziel aufweisen sollte, um den besten Datendurchsatz zu erzielen.
Rückgabewert
Nichts
Bemerkungen
Um die Angabe an den überlagernden Treiber oder Hoststapel zu verteilen, ruft der Zwischentreiber den NdisTcpOffloadEventHandler-Funktion auf. Der Zwischentreiber übergibt die folgenden Parameter an die
NdisTcpOffloadEventHandler Funktion:
- Die NdisOffloadHandle, dass das Offloadziel in seinem Kontext für die entladene TCP-Verbindung gespeichert wurde. Weitere Informationen finden Sie unter verweisen auf den ausgeladenen Zustand über einen Zwischentreiber.
- Der EventType, den NDIS an die ProtocolTcpOffloadEvent--Funktion des Zwischentreibers übergeben hat.
- Die EventSpecificInformation, die NDIS an die ProtocolTcpOffloadEvent-Funktion des Zwischentreibers übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | ndischimney.h (include Ndischimney.h) |