RIO_BUF-Struktur (mswsockdef.h)
Die RIO_BUF-Struktur gibt einen Teil eines registrierten Puffers an, der zum Senden oder Empfangen von Netzwerkdaten mit den registrierten Winsock-E/A-Erweiterungen verwendet wird.
Syntax
typedef struct _RIO_BUF {
RIO_BUFFERID BufferId;
ULONG Offset;
ULONG Length;
} RIO_BUF, *PRIO_BUF;
Member
BufferId
Der registrierte Pufferdeskriptor für einen von Winsock registrierten E/A-Puffer, der mit Sende- und Empfangsanforderungen verwendet wird.
Offset
Der Offset in Bytes in den puffer, der vom BufferId-Element angegeben wird. Ein Offsetwert von null Punkten bis zum Anfang des Puffers
Length
Eine Länge (in Bytes) des Puffers, der vom Offset-Element verwendet werden soll.
Hinweise
Die von Winsock registrierten E/A-Erweiterungen werden häufig für Teile registrierter Puffer ausgeführt, die manchmal als Puffers slices bezeichnet werden. Die RIO_BUF-Struktur wird von einer Anwendung verwendet, die eine kleine Menge an registriertem Arbeitsspeicher zum Senden oder Empfangen von Netzwerkdaten verwenden muss. Die Anwendung kann häufig die Leistung steigern, indem sie einen großen Puffer registriert und dann nach Bedarf kleine Blöcke des Puffers verwendet. Die RIO_BUF-Struktur kann jedes zusammenhängende Segment des Arbeitsspeichers beschreiben, das in einer einzelnen Pufferregistrierung enthalten ist.
Ein Zeiger auf eine RIO_BUF-Struktur wird als pData-Parameter an die Funktionen RIOSend, RIOSendEx, RIOReceive und RIOReceiveEx übergeben, um Netzwerkdaten zu senden oder zu empfangen.
Eine Anwendung kann die Größe eines registrierten Puffers nicht einfach mithilfe eines Pufferslices mit Werten ändern, die größer sind als der ursprüngliche Puffer, der mit der RIORegisterBuffer-Funktion registriert wurde.
Die RIO_BUF-Struktur wird in der Headerdatei "Mswsockdef.h " definiert, die automatisch in der Headerdatei "Mswsock.h " enthalten ist. Die Headerdatei "Mswsockdef.h " sollte nie direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | mswsockdef.h (einschließlich Mswsock.h) |