LPFN_RIOSEND fungsi panggilan balik (mswsock.h)
Fungsi RIOSend mengirim data jaringan pada soket I/O TCP terdaftar yang terhubung atau soket I/O UDP terikat yang terdaftar untuk digunakan dengan ekstensi I/O terdaftar Winsock.
Sintaks
LPFN_RIOSEND LpfnRiosend;
BOOL LpfnRiosend(
RIO_RQ SocketQueue,
PRIO_BUF pData,
ULONG DataBufferCount,
DWORD Flags,
PVOID RequestContext
)
{...}
Parameter
SocketQueue
Deskriptor yang mengidentifikasi soket TCP I/O terdaftar yang terhubung atau soket UDP I/O terikat yang terdaftar.
pData
Deskripsi bagian buffer terdaftar untuk mengirim data.
Parameter ini mungkin NULL untuk soket UDP I/O terikat jika aplikasi tidak perlu mengirim payload data dalam datagram UDP.
DataBufferCount
Parameter jumlah buffer data yang menunjukkan apakah data akan dikirim dalam buffer yang ditunjukkan oleh parameter pData .
Parameter ini harus diatur ke nol jika pData adalah NULL. Jika tidak, parameter ini harus diatur ke 1.
Flags
Sekumpulan bendera yang memodifikasi perilaku fungsi RIOSend .
Parameter Bendera dapat berisi kombinasi opsi berikut, yang ditentukan dalam Mswsockdef.h file header:
RIO_MSG_COMMIT_ONLY
Permintaan sebelumnya yang ditambahkan dengan bendera RIO_MSG_DEFER akan diterapkan.
Ketika bendera RIO_MSG_COMMIT_ONLY diatur, tidak ada bendera lain yang dapat ditentukan. Ketika bendera RIO_MSG_COMMIT_ONLY diatur, argumen pData dan RequestContext harus NULL, dan argumen DataBufferCount harus nol.
Bendera ini biasanya akan digunakan sesekali setelah sejumlah permintaan dikeluarkan dengan set bendera RIO_MSG_DEFER . Ini menghilangkan kebutuhan saat menggunakan bendera RIO_MSG_DEFER untuk membuat permintaan terakhir tanpa bendera RIO_MSG_DEFER , yang menyebabkan permintaan terakhir selesai jauh lebih lambat daripada permintaan lain.
Tidak seperti panggilan lain ke fungsi RIOSend , ketika bendera RIO_MSG_COMMIT_ONLY diatur, panggilan ke fungsi RIOSend tidak perlu diserialisasikan. Untuk satu RIO_RQ, fungsi RIOSend dapat dipanggil dengan RIO_MSG_COMMIT_ONLY pada satu utas sambil memanggil fungsi RIOSend pada utas lain.
RIO_MSG_DONT_NOTIFY
Permintaan tidak boleh memicu fungsi RIONotify ketika penyelesaian permintaan dimasukkan ke dalam antrean penyelesaiannya.
RIO_MSG_DEFER
Permintaan tidak perlu segera dijalankan. Ini akan memasukkan permintaan ke dalam antrean permintaan, tetapi mungkin atau mungkin tidak memicu eksekusi permintaan.
Mengirim data mungkin tertunda hingga permintaan pengiriman dibuat pada RIO_RQ diteruskan dalam parameter SocketQueue tanpa bendera RIO_MSG_DEFER diatur. Untuk memicu eksekusi untuk semua pengiriman dalam antrean kirim, panggil fungsi RIOSend atau RIOSendEx tanpa bendera RIO_MSG_DEFER diatur.
Catatan
Permintaan pengiriman dibebankan terhadap kapasitas I/O yang beredar pada RIO_RQ yang diteruskan dalam parameter SocketQueue terlepas dari apakah RIO_MSG_DEFER ditetapkan.
RequestContext
Nilai kembali
Jika tidak ada kesalahan yang terjadi, fungsi RIOSend mengembalikan TRUE. Dalam hal ini, operasi pengiriman berhasil dimulai dan penyelesaian akan telah diantrekan atau operasi telah berhasil dimulai dan penyelesaian akan diantrekan di lain waktu.
Nilai FALSE menunjukkan fungsi gagal, operasi tidak berhasil dimulai dan tidak ada indikasi penyelesaian yang akan diantrekan. Kode kesalahan tertentu dapat diambil dengan memanggil fungsi WSAGetLastError .
| Menampilkan kode | Deskripsi |
|---|---|
| WSAEFAULT | Sistem mendeteksi alamat penunjuk yang tidak valid dalam mencoba menggunakan argumen pointer dalam panggilan. Kesalahan ini dikembalikan jika pengidentifikasi buffer dibatalkan pendaftarannya atau buffer dibebaskan untuk salah satu struktur RIO_BUF yang diteruskan dalam parameter sebelum operasi diantrekan atau dipanggil. |
| WSAEINVAL | Parameter yang tidak valid diteruskan ke fungsi. Kesalahan ini dikembalikan jika parameter SocketQueue tidak valid, parameter Bendera berisi nilai yang tidak valid untuk operasi pengiriman, atau integritas antrean penyelesaian telah disusupi. Kesalahan ini juga dapat dikembalikan untuk masalah lain dengan parameter. |
| WSAENOBUFS | Memori yang cukup tidak dapat dialokasikan. Kesalahan ini dikembalikan jika antrean penyelesaian I/O yang terkait dengan parameter SocketQueue penuh atau antrean penyelesaian I/O dibuat dengan entri nol kirim. |
| WSA_IO_PENDING | Operasi telah berhasil dimulai dan penyelesaian akan diantrekan di lain waktu. |
Keterangan
Aplikasi dapat menggunakan fungsi RIOSend untuk mengirim data jaringan dari buffer apa pun yang sepenuhnya terkandung dalam satu buffer terdaftar. Anggota Offset dan Length dari struktur RIO_BUF yang ditunjukkan oleh parameter pData menentukan data jaringan yang akan dikirim dari buffer.
Buffer yang terkait dengan operasi kirim tidak boleh digunakan bersamaan dengan operasi kirim atau terima lain. Buffer, dan pendaftaran buffer, harus tetap berlaku selama durasi operasi pengiriman. Ini berarti bahwa Anda tidak boleh meneruskan PRIO_BUF yang sama ke permintaan RIOSend(Ex) ketika permintaan sudah tertunda. Hanya setelah permintaan RIOSend(Ex) dalam penerbangan selesai jika Anda menggunakan kembali PRIO_BUF yang sama (baik dengan offset yang sama atau dengan offset dan panjang yang berbeda). Selain itu, ketika mengirim referensi data buffer terdaftar (baik sebagian atau seluruh buffer), seluruh buffer terdaftar tidak boleh digunakan sampai pengiriman selesai. Ini termasuk menggunakan sebagian buffer terdaftar untuk operasi penerimaan atau operasi pengiriman lainnya.
Parameter Bendera dapat digunakan untuk memengaruhi perilaku fungsi RIOSend di luar opsi yang ditentukan untuk soket terkait. Perilaku fungsi ini ditentukan oleh kombinasi opsi soket apa pun yang diatur pada soket yang terkait dengan parameter SocketQueue dan nilai yang ditentukan dalam parameter Bendera .
Catatan
Penunjuk fungsi ke fungsi RIOSend harus diperoleh pada durasi dengan melakukan panggilan ke fungsi WSAIoctl dengan opcode SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER yang ditentukan. Buffer input yang diteruskan ke fungsi WSAIoctl harus berisi WSAID_MULTIPLE_RIO, pengidentifikasi unik global (GUID) yang nilainya mengidentifikasi fungsi ekstensi I/O terdaftar Winsock. Setelah berhasil, output yang dikembalikan oleh fungsi WSAIoctl berisi pointer ke struktur RIO_EXTENSION_FUNCTION_TABLE yang berisi pointer ke fungsi ekstensi I/O terdaftar Winsock. IOCTL SIO_GET_MULTIPLE_EXTENSION_FUNCTION_POINTER didefinisikan dalam file header Ws2def.h. GUID WSAID_MULTIPLE_RIO didefinisikan dalam file header Mswsock.h .
Windows Phone 8: Fungsi ini didukung untuk aplikasi Windows Phone Store di Windows Phone 8 dan yang lebih baru.
Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | mswsock.h |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk