estructura RIO_BUF (mswsockdef.h)

Artículo
02/29/2024

La estructura de RIO_BUF especifica una parte de un búfer registrado que se usa para enviar o recibir datos de red con las extensiones de E/S registradas de Winsock.

Sintaxis

typedef struct _RIO_BUF {
  RIO_BUFFERID BufferId;
  ULONG        Offset;
  ULONG        Length;
} RIO_BUF, *PRIO_BUF;

Miembros

BufferId

Descriptor de búfer registrado para un búfer de E/S registrado de Winsock usado con solicitudes de envío y recepción.

Offset

Desplazamiento, en bytes, en el búfer especificado por el miembro BufferId . Un valor offset de cero puntos al principio del búfer

Length

Longitud, en bytes, del búfer que se va a usar desde el miembro Offset .

Comentarios

Las extensiones de E/S registradas de Winsock suelen funcionar en partes de búferes registrados a veces denominadas segmentos de búfer. Una aplicación usa la estructura RIO_BUF que necesita usar una pequeña cantidad de memoria registrada para enviar o recibir datos de red. La aplicación a menudo puede aumentar el rendimiento registrando un búfer grande y, a continuación, usando pequeños fragmentos del búfer según sea necesario. La estructura RIO_BUF puede describir cualquier segmento contiguo de memoria contenido en un único registro de búfer.

Un puntero a una estructura de RIO_BUF se pasa como parámetro pData a las funciones RIOSend, RIOSendEx, RIOReceive y RIOReceiveEx para enviar o recibir datos de red.

Una aplicación no puede cambiar el tamaño de un búfer registrado simplemente mediante un segmento de búfer con valores mayores que el búfer original que se registró mediante la función RIORegisterBuffer .

La estructura RIO_BUF se define en el archivo de encabezado Mswsockdef.h , que se incluye automáticamente en el archivo de encabezado Mswsock.h . El archivo de encabezado Mswsockdef.h nunca se debe usar directamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Encabezado	mswsockdef.h (incluya Mswsock.h)