RIO_BUF-Struktur (mswsockdef.h)

Artikel
02/29/2024

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)