RIORESULT-Struktur (mswsockdef.h)

Artikel
02/29/2024

Die RIORESULT-Struktur enthält Daten, die verwendet werden, um Die Ergebnisse der Anforderungsabschluss anzugeben, die mit den registrierten Winsock-E/A-Erweiterungen verwendet werden.

Syntax

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

Member

Status

Der Abschluss status der winsock-registrierten E/A-Anforderung.

BytesTransferred

Die Anzahl der in der E/A-Anforderung gesendeten oder empfangenen Bytes.

SocketContext

Ein von der Anwendung bereitgestellter Kontext, der im Aufruf der RIOCreateRequestQueue-Funktion angegeben wird.

RequestContext

Ein von der Anwendung bereitgestellter Kontext, der mit der registrierten E/A-Anforderung für die Funktionen RIOReceive, RIOReceiveEx, RIOSend und RIOSendEx angegeben wird.

Hinweise

Die RIORESULT-Struktur definiert das Datenformat, das verwendet wird, um den Abschluss der Anforderung durch die registrierten Winsock-E/A-Erweiterungen anzugeben. Eine Anwendung fordert Vervollständigungsanzeigen an, indem ein Array von RIORESULT-Strukturen zugewiesen und das Array der RIORESULT-Strukturen zusammen mit der Elementanzahl an die RIODequeueCompletion-Funktion übergeben wird. Die Anwendung muss keine Initialisierung der RIORESULT-Strukturelemente durchführen, bevor die RIODequeueCompletion-Funktion aufgerufen wird.

Der SocketContext-Member der RIORESULT-Struktur kann von einer Anwendung verwendet werden, um das RIO_CQ-Objekt oder das zugeordnete Anwendungsobjekt zu identifizieren, für das die winsock-registrierte E/A-Anforderung ausgestellt wurde. Das RequestContext-Element der RIORESULT-Struktur kann auf ähnliche Weise verwendet werden, um die bestimmte winsock-registrierte E/A-Anforderung zu identifizieren, die abgeschlossen wurde.

Die RIORESULT-Struktur ist in der Headerdatei Mswsockdef.h definiert, die automatisch in der Headerdatei Mswsock.h enthalten ist. Die Headerdatei "Mswsockdef.h " sollte niemals direkt verwendet werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Kopfzeile	mswsockdef.h (mswsock.h einschließen)

Weitere Informationen

RIOCreateRequestQueue