Struktur RIORESULT (mswsockdef.h)

Artikel
03/15/2023

Struktur RIORESULT berisi data yang digunakan untuk menunjukkan hasil penyelesaian permintaan yang digunakan dengan ekstensi I/O terdaftar Winsock.

Sintaks

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

Anggota

Status

Status penyelesaian permintaan I/O terdaftar Winsock.

BytesTransferred

Jumlah byte yang dikirim atau diterima dalam permintaan I/O.

SocketContext

Konteks yang disediakan aplikasi yang ditentukan dalam panggilan ke fungsi RIOCreateRequestQueue .

RequestContext

Konteks yang disediakan aplikasi yang ditentukan dengan permintaan I/O terdaftar ke fungsi RIOReceive, RIOReceiveEx, RIOSend, dan RIOSendEx .

Keterangan

Struktur RIORESULT mendefinisikan format data yang digunakan untuk menunjukkan penyelesaian permintaan oleh ekstensi I/O terdaftar Winsock. Aplikasi meminta indikasi penyelesaian dengan mengalokasikan array struktur RIORESULT dan meneruskan array struktur RIORESULT ke fungsi RIODequeueCompletion bersama dengan jumlah elemen. Aplikasi tidak perlu melakukan inisialisasi elemen struktur RIORESULT sebelum memanggil fungsi RIODequeueCompletion .

Anggota SocketContext dari struktur RIORESULT dapat digunakan oleh aplikasi untuk mengidentifikasi objek RIO_CQ atau objek aplikasi terkait tempat permintaan I/O terdaftar Winsock dikeluarkan. Anggota RequestContext dari struktur RIORESULT juga dapat digunakan untuk mengidentifikasi permintaan I/O terdaftar Winsock tertentu yang telah selesai.

Struktur RIORESULT didefinisikan dalam file header Mswsockdef.h yang secara otomatis disertakan dalam file header Mswsock.h . File header Mswsockdef.h tidak boleh digunakan secara langsung.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	mswsockdef.h (termasuk Mswsock.h)