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)

Weitere Informationen

NdisTcpOffloadEventHandler