PFN_WSK_SEND_BACKLOG_EVENT Rückruffunktion (wsk.h)
Die WskSendBacklogEvent Ereignisrückruffunktion benachrichtigt eine WSK-Anwendung, wenn sich die ideale Größe des Senderücks für einen verbindungsorientierten Socket ändert.
Syntax
PFN_WSK_SEND_BACKLOG_EVENT PfnWskSendBacklogEvent;
NTSTATUS PfnWskSendBacklogEvent(
[in, optional] PVOID SocketContext,
[in] SIZE_T IdealBacklogSize
)
{...}
Parameter
[in, optional] SocketContext
Ein Zeiger auf den Socketkontext für den verbindungsorientierten Socket, der die WSK-Anwendung über eine Änderung an der idealen Größe des Senderücks informiert. Die WSK-Anwendung hat diesen Zeiger auf das WSK-Subsystem auf eine der folgenden Arten bereitgestellt:
- Es hat die WskSocket--Funktion aufgerufen, um den Socket zu erstellen.
- Sie hat die WskSocketConnect-Funktion aufgerufen, um den Socket zu erstellen.
- Sie hat die WskAccept--Funktion aufgerufen, um den Socket als eingehende Verbindung zu akzeptieren.
- Die WskAcceptEvent Ereignisrückruffunktion wurde aufgerufen, um den Socket als eingehende Verbindung zu akzeptieren.
[in] IdealBacklogSize
Eine Variable, die die neue ideale Größe des Senderückslogs enthält.
Rückgabewert
Die WskSendBacklogEvent Ereignisrückruffunktion einer WSK-Anwendung muss immer STATUS_SUCCESS zurückgeben.
Bemerkungen
Das WSK-Subsystem ruft die WskSendBacklogEvent Ereignisrückruffunktion auf, wenn sich die ideale Änderung der Größe des Backlogs für einen verbindungsorientierten Socket nur ändert, wenn die Ereignisrückruffunktion zuvor mit der SO_WSK_EVENT_CALLBACK Socketoption aktiviert wurde. Weitere Informationen zum Aktivieren der Ereignisrückruffunktionen eines Sockets finden Sie unter Aktivieren und Deaktivieren von Ereignisrückruffunktionen.
Die ideale Sende-Backlog-Größe für einen verbindungsorientierten Socket ist die optimale Menge an Sendedaten, die offen gehalten werden müssen (d. h. an das WSK-Subsystem übergeben, aber noch nicht abgeschlossen), um den Datenstrom des Sockets jederzeit voll zu halten. Eine WSK-Anwendung kann diese Größe verwenden, um die Puffer von Daten, die basierend auf dem Flusssteuerungszustand der zugrunde liegenden Verbindung gesendet werden, inkrementell zu testen und zu sperren.
Eine WSK-Anwendung kann die aktuelle ideale Backloggröße für einen verbindungsorientierten Socket jederzeit abrufen, indem sie die WskControlSocket--Funktion aufrufen.
Das WSK-Subsystem ruft die WskSendBacklogEvent Ereignisrückruffunktion bei IRQL <= DISPATCH_LEVEL auf.
Die WskSendBacklogEvent Ereignisrückruffunktion einer WSK-Anwendung darf nicht auf den Abschluss anderer WSK-Anforderungen im Kontext von WSK-Abschluss- oder Ereignisrückruffunktionen warten. Der Rückruf kann andere WSK-Anforderungen initiieren (vorausgesetzt, es verbringt nicht zu viel Zeit bei DISPATCH_LEVEL), aber er darf nicht auf den Abschluss warten, auch wenn der Rückruf bei IRQL = PASSIVE_LEVEL aufgerufen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform- | Fenster |
| Header- | wsk.h (include Wsk.h) |
| IRQL- | <= DISPATCH_LEVEL |