Structure RIORESULT (mswsockdef.h)

La structure RIORESULT contient des données utilisées pour indiquer les résultats d’achèvement de la demande utilisés avec les extensions d’E/S inscrites dans Winsock.

Syntaxe

typedef struct _RIORESULT {
  LONG      Status;
  ULONG     BytesTransferred;
  ULONGLONG SocketContext;
  ULONGLONG RequestContext;
} RIORESULT, *PRIORESULT;

Membres

Status

Achèvement status de la demande d’E/S inscrite winsock.

BytesTransferred

Nombre d’octets envoyés ou reçus dans la demande d’E/S.

SocketContext

Contexte fourni par l’application spécifié dans l’appel à la fonction RIOCreateRequestQueue .

RequestContext

Contexte fourni par l’application spécifié avec la demande d’E/S inscrite pour les fonctions RIOReceive, RIOReceiveEx, RIOSend et RIOSendEx .

Remarques

La structure RIORESULT définit le format de données utilisé pour indiquer l’achèvement de la demande par les extensions d’E/S inscrites dans Winsock. Une application demande des indications d’achèvement en allouant un tableau de structures RIORESULT et en transmettant le tableau de structures RIORESULT à la fonction RIODequeueCompletion avec le nombre d’éléments. L’application n’a pas besoin d’initialiser les éléments de structure RIORESULT avant d’appeler la fonction RIODequeueCompletion .

Le membre SocketContext de la structure RIORESULT peut être utilisé par une application pour identifier l’objet RIO_CQ ou l’objet d’application associé sur lequel la demande d’E/S inscrite winsock a été émise. Le membre RequestContext de la structure RIORESULT peut également être utilisé pour identifier la demande d’E/S inscrite winsock particulière qui a été effectuée.

La structure RIORESULT 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)

Voir aussi

RIOCreateRequestQueue

RIODequeueCompletion

RIOReceive

RIOReceiveEx

RIOSend

RIOSendEx