estrutura RIO_BUF (mswsockdef.h)

Artigo
03/05/2024

A estrutura RIO_BUF especifica uma parte de um buffer registrado usado para enviar ou receber dados de rede com as extensões de E/S registradas do Winsock.

Sintaxe

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

Membros

BufferId

O descritor de buffer registrado para um buffer de E/S registrado do Winsock usado com solicitações de envio e recebimento.

Offset

O deslocamento, em bytes, para o buffer especificado pelo membro BufferId . Um valor offset de zero pontos para o início do buffer

Length

Um comprimento, em bytes, do buffer a ser usado do membro Offset .

Comentários

As extensões de E/S registradas do Winsock geralmente operam em partes de buffers registrados às vezes chamadas de fatias de buffer. A estrutura RIO_BUF é usada por um aplicativo que precisa usar uma pequena quantidade de memória registrada para enviar ou receber dados de rede. O aplicativo geralmente pode aumentar o desempenho registrando um buffer grande e, em seguida, usando pequenas partes do buffer, conforme necessário. A estrutura RIO_BUF pode descrever qualquer segmento contíguo de memória contido em um único registro de buffer.

Um ponteiro para uma estrutura RIO_BUF é passado como o parâmetro pData para as funções RIOSend, RIOSendEx, RIOReceive e RIOReceiveEx para enviar ou receber dados de rede.

Um aplicativo não pode redimensionar um buffer registrado simplesmente usando uma fatia de buffer com valores maiores que o buffer original que foi registrado usando a função RIORegisterBuffer .

A estrutura RIO_BUF é definida no arquivo de cabeçalho Mswsockdef.h que é incluído automaticamente no arquivo de cabeçalho Mswsock.h . O arquivo de cabeçalho Mswsockdef.h nunca deve ser usado diretamente.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	mswsockdef.h (inclua Mswsock.h)