SIO_WSK_QUERY_IDEAL_SEND_BACKLOG
Mit dem SIO_WSK_QUERY_IDEAL_SEND_BACKLOG Socket-E/A-Steuerungsvorgang kann eine WSK-Anwendung die ideale Sende-Backlog-Größe für einen verbindungsorientierten Socket abfragen. Dieser Socket-E/A-Steuerungsvorgang gilt nur für verbindungsorientierte Sockets.
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.
Wenn eine WSK-Anwendung diesen Socket-E/A-Steuerungsvorgang verwendet, um die ideale Sende-Backlog-Größe abzufragen, muss dies geschehen, nachdem der verbindungsorientierte Socket mit einer Remote-Transportadresse verbunden wurde.
Um die ideale Sende-Backlog-Größe für einen verbindungsorientierten Socket abzufragen, ruft eine WSK-Anwendung die WskControlSocket--Funktion mit den folgenden Parametern auf.
Parameter | Wert |
---|---|
RequestType- |
WskIoctl |
ControlCode- |
SIO_WSK_QUERY_IDEAL_SEND_BACKLOG |
Level- |
0 |
InputSize- |
0 |
InputBuffer- |
NULL |
OutputSize- |
sizeof(SIZE_T) |
OutputBuffer- |
Ein Zeiger auf eine variable SIZE_T Typ, die die aktuelle ideale Größe des Senderückstands empfängt |
OutputSizeReturned |
NULL |
Eine WSK-Anwendung muss einen Zeiger auf ein IRP angeben, wenn die WskControlSocket--Funktion aufgerufen wird, um die ideale Sende-Backlog-Größe für einen verbindungsorientierten Socket abzufragen.
Ein verbindungsorientierter Socket kann über Änderungen an der idealen Sende-Backlog-Größe benachrichtigt werden, indem die WskSendBacklogEvent Ereignisrückruffunktion aktiviert wird.
Anforderungen
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Kopfball |
Wsk.h (enthalten Wsk.h) |