Freigeben über


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)