Freigeben über


SIO_WSK_QUERY_IDEAL_SEND_BACKLOG

Der SIO_WSK_QUERY_IDEAL_SEND_BACKLOG Socket-E/A-Steuerungsvorgang ermöglicht es einer WSK-Anwendung, die ideale Sendebackloggröße für einen verbindungsorientierten Socket abzufragen. Dieser Socket-E/A-Steuerungsvorgang gilt nur für verbindungsorientierte Sockets.

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.

Wenn eine WSK-Anwendung diesen Socket-E/A-Steuerungsvorgang verwendet, um die ideale Größe des Sendebacklogs abzufragen, muss sie dies tun, nachdem der verbindungsorientierte Socket mit einer Remotetransportadresse verbunden wurde.

Um die ideale Größe des Sendebacklogs 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 SIZE_T typisierte Variable, die die aktuelle ideale Größe des Sendebacklogs empfängt.

OutputSizeReturned

NULL

Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket-Funktion einen Zeiger auf einen IRP angeben, um die ideale Größe des Sendebacklogs für einen verbindungsorientierten Socket abzufragen.

Ein verbindungsorientierter Socket kann über Änderungen an der idealen Größe des Sendebacklogs benachrichtigt werden, indem seine WskSendBacklogEvent-Ereignisrückruffunktion aktiviert wird.

Requirements (Anforderungen)

Version

Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.

Header

Wsk.h (einschließen von Wsk.h)