SO_RCVBUF
Die Option SO_RCVBUF Socket bestimmt die Größe des Empfangspuffers eines Sockets, der vom zugrunde liegenden Transport verwendet wird. Diese Socketoption gilt nur für lauschende Sockets, Datagrammsockets und verbindungsorientierte Sockets.
Um den Wert dieser Socketoption festzulegen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.
Parameter | Wert |
---|---|
Requesttype |
WskSetOption |
ControlCode |
SO_RCVBUF |
Level |
SOL_SOCKET |
InputSize |
sizeof(ULONG) |
Inputbuffer |
Ein Zeiger auf eine ULONG-typisierte Variable, die die neue Größe des Empfangspuffers des Sockets enthält |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
Um den Wert der SO_RCVBUF Socketoption abzurufen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.
Parameter | Wert |
---|---|
Requesttype |
WskGetOption |
ControlCode |
SO_RCVBUF |
Level |
SOL_SOCKET |
InputSize |
0 |
Inputbuffer |
NULL |
OutputSize |
sizeof(ULONG) |
OutputBuffer |
Ein Zeiger auf eine ULONG-typisierte Variable, die die aktuelle Größe des Empfangspuffers des Sockets empfängt |
OutputSizeReturned |
NULL |
Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket-Funktion einen Zeiger auf einen IRP angeben, um den Wert der SO_RCVBUF Socketoption festzulegen oder abzurufen.
Die Standardgröße des Empfangspuffers eines Sockets ist transportspezifisch. Einige Transporte unterstützen diese Socketoption möglicherweise nicht.
Wenn diese Socketoption für einen Abhörsocket festgelegt ist, wird für alle eingehenden Verbindungen, die in diesem Abhörsocket akzeptiert werden, ihr Empfangspuffer auf die gleiche Größe festgelegt, die für den Abhörsocket angegeben ist. Eine WSK-Anwendung kann die WskControlSocket-Funktion auf einem akzeptierten Socket aufrufen, um die Größe des Empfangspuffers zu überschreiben, der vom Lauschocket geerbt wurde.
Requirements (Anforderungen)
Version |
Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
Header |
Ws2def.h (einschließlich Wsk.h) |