Struttura RIORESULT (mswsockdef.h)

Articolo
02/29/2024

La struttura RIORESULT contiene dati usati per indicare i risultati di completamento delle richieste usati con le estensioni di I/O registrate winsock.

Sintassi

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

Members

Status

Stato di completamento della richiesta di I/O registrata winsock.

BytesTransferred

Numero di byte inviati o ricevuti nella richiesta di I/O.

SocketContext

Contesto specificato dall'applicazione nella chiamata alla funzione RIOCreateRequestQueue .

RequestContext

Contesto specificato dall'applicazione con la richiesta di I/O registrata alle funzioni RIOReceive, RIOReceiveEx, RIOSend e RIOSendEx.

Commenti

La struttura RIORESULT definisce il formato di dati utilizzato per indicare il completamento della richiesta dalle estensioni di I/O registrate da Winsock. Un'applicazione richiede indicazioni di completamento assegnando una matrice di strutture RIORESULT e passando la matrice di strutture RIORESULT alla funzione RIODequeueCompletion insieme al conteggio degli elementi. L'applicazione non deve eseguire alcuna inizializzazione degli elementi della struttura RIORESULT prima di chiamare la funzione RIODequeueCompletion .

Il membro SocketContext della struttura RIORESULT può essere usato da un'applicazione per identificare l'oggetto RIO_CQ o l'oggetto applicazione associato in cui è stata emessa la richiesta di I/O registrata Winsock. Il membro RequestContext della struttura RIORESULT può essere usato in modo analogo per identificare la richiesta di I/O registrata winsock specificata che è stata completata.

La struttura RIORESULT è definita nel file di intestazione Mswsockdef.h incluso automaticamente nel file di intestazione Mswsock.h . Il file di intestazione Mswsockdef.h non deve mai essere usato direttamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Intestazione	mswsockdef.h (includere Mswsock.h)