TCP_OFFLOAD_EVENT_HANDLER Rückruffunktion (ndischimney.h)
[Das TCP-Chimney-Auslagerungsfeature ist veraltet und sollte nicht verwendet werden.]
NDIS ruft die ProtocolIndicateOffloadEvent-Funktion eines Protokolltreibers oder eines Zwischentreibers auf, um einen Hinweis zu posten, der durch den Aufruf eines zugrunde liegenden Treibers oder des Auslagerungsziels an den 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, für die die Angabe erfolgt. Der Protokoll- oder Zwischentreiber hat diesen Zeiger als Eingabeparameter für die NdisInitiateOffload-Funktion beim Ausladen der Verbindung bereitgestellt.
[in] EventType
Das Ereignis, das als eines der folgenden TCP_OFFLOAD_EVENT_TYPE Werte angegeben wird:
TcpIndicateDisconnect
Gibt an, dass der Remotehost eine ordnungsgemäße Trennung initiiert hat, indem er ein FIN-Segment für die Verbindung sendet.
TcpIndicateRetrieve
Gibt an, dass das Auslagerungsziel den Hoststapel anfordert, um die Auslagerung einer TCP-Verbindung zu beenden.
TcpIndicateAbort
Gibt an, dass der Remotehost eine abgebrochene Trennung initiiert hat, indem er ein akzeptables RST-Segment für die Verbindung sendet.
TcpIndicateSendBacklogChange
Gibt eine Änderung der bevorzugten Größe des Sendebacklogs 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 Auslagerungsziel ausstehen sollte, um den besten Datendurchsatz zu erzielen.
Rückgabewert
Keine
Bemerkungen
Um den Hinweis an den überlagernden Treiber oder Hoststapel weiterzuverbreiten, ruft der Zwischentreiber die Funktion NdisTcpOffloadEventHandler auf. Der Zwischentreiber übergibt die folgenden Parameter an den
NdisTcpOffloadEventHandler-Funktion :
- Das NdisOffloadHandle , das das Auslagerungsziel in seinem Kontext für die entladene TCP-Verbindung gespeichert hat. 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 hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | ndischimney.h (include Ndischimney.h) |