structure RIO_BUF (mswsockdef.h)

Article
02/29/2024

La structure RIO_BUF spécifie une partie d’une mémoire tampon inscrite utilisée pour l’envoi ou la réception de données réseau avec les extensions d’E/S inscrites winsock.

Syntaxe

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

Membres

BufferId

Descripteur de mémoire tampon inscrit pour une mémoire tampon d’E/S inscrite dans Winsock utilisée avec les demandes d’envoi et de réception.

Offset

Décalage, en octets, dans la mémoire tampon spécifiée par le membre BufferId . Une valeur de décalage de zéro pointe vers le début de la mémoire tampon

Length

Longueur, en octets, de la mémoire tampon à utiliser à partir du membre Offset .

Remarques

Les extensions d’E/S inscrites winsock fonctionnent souvent sur des parties de mémoires tampons inscrites, parfois appelées tranches de mémoire tampon. La structure RIO_BUF est utilisée par une application qui doit utiliser une petite quantité de mémoire inscrite pour envoyer ou recevoir des données réseau. L’application peut souvent augmenter les performances en inscrivant une mémoire tampon de grande taille, puis en utilisant de petits blocs de la mémoire tampon si nécessaire. La structure RIO_BUF peut décrire n’importe quel segment contigu de mémoire contenue dans une seule inscription de mémoire tampon.

Un pointeur vers une structure RIO_BUF est passé en tant que paramètre pData aux fonctions RIOSend, RIOSendEx, RIOReceive et RIOReceiveEx pour envoyer ou recevoir des données réseau.

Une application ne peut pas redimensionner une mémoire tampon inscrite simplement à l’aide d’une tranche de mémoire tampon avec des valeurs supérieures à la mémoire tampon d’origine qui a été inscrite à l’aide de la fonction RIORegisterBuffer .

La structure RIO_BUF est définie dans le fichier d’en-tête Mswsockdef.h qui est automatiquement inclus dans le fichier d’en-tête Mswsock.h . Le fichier d’en-tête Mswsockdef.h ne doit jamais être utilisé directement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	mswsockdef.h (inclure Mswsock.h)