PFN_WSK_SEND_BACKLOG_EVENT Rückruffunktion (wsk.h)

Artikel
08/08/2023

Die WskSendBacklogEvent-Ereignisrückruffunktion benachrichtigt eine WSK-Anwendung, wenn sich die ideale Größe des Sendebacklogs 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 der idealen Größe des Sendebacklogs benachrichtigt. Die WSK-Anwendung hat diesen Zeiger auf das WSK-Subsystem auf eine der folgenden Arten bereitgestellt:

Die WskSocket-Funktion wurde aufgerufen, um den Socket zu erstellen.
Die WskSocketConnect-Funktion wurde aufgerufen, um den Socket zu erstellen.
Die WskAccept-Funktion wurde 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 Sendebacklogs enthält.

Rückgabewert

Die WskSendBacklogEvent-Ereignisrückruffunktion einer WSK-Anwendung muss immer STATUS_SUCCESS zurückgeben.

Hinweise

Das WSK-Subsystem ruft die WskSendBacklogEvent-Ereignisrückruffunktion einer WSK-Anwendung auf, wenn sich die ideale Größe des Sendebacklogs für einen verbindungsorientierten Socket nur ändert, wenn die Ereignisrückruffunktion zuvor mit der Option SO_WSK_EVENT_CALLBACK Socket aktiviert wurde. Weitere Informationen zum Aktivieren der Ereignisrückruffunktionen eines Sockets finden Sie unter Aktivieren und Deaktivieren von Ereignisrückruffunktionen.

Die ideale Größe des Sendebacklogs für einen verbindungsorientierten Socket ist die optimale Menge an Sendedaten, die ausstehend aufbewahrt 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 Zu sendenden Puffer von Daten basierend auf dem Flusssteuerungszustand der zugrunde liegenden Verbindung inkrementell zu testen und zu sperren.

Eine WSK-Anwendung kann jederzeit die aktuelle ideale Backloggröße für einen verbindungsorientierten Socket abrufen, indem die WskControlSocket-Funktion aufgerufen wird .

Das WSK-Subsystem ruft die WskSendBacklogEvent-Ereignisrückruffunktion einer WSK-Anwendung unter IRQL <= DISPATCH_LEVEL auf.

Die WskSendBacklogEvent-Ereignisrückruffunktion einer WSK-Anwendung darf nicht auf den Abschluss anderer WSK-Anforderungen im Kontext von WSK-Vervollständigungs- oder Ereignisrückruffunktionen warten. Der Rückruf kann andere WSK-Anforderungen initiieren (vorausgesetzt, er verbringt nicht zu viel Zeit mit DISPATCH_LEVEL), aber er darf nicht auf deren Abschluss warten, auch wenn der Rückruf unter IRQL = PASSIVE_LEVEL aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Windows
Kopfzeile	wsk.h (einschließen von Wsk.h)
IRQL	<= DISPATCH_LEVEL