Struktur WSAPOLLFD (winsock2.h)
Struktur WSAPOLLFD menyimpan informasi soket yang digunakan oleh fungsi WSAPoll .
Sintaks
typedef struct pollfd {
SOCKET fd;
SHORT events;
SHORT revents;
} WSAPOLLFD, *PWSAPOLLFD, *LPWSAPOLLFD;
Anggota
fd
Jenis: SOCKET
Pengidentifikasi soket untuk menemukan status. Parameter ini diabaikan jika diatur ke nilai negatif. Lihat Keterangan.
events
Jenis: pendek
Sekumpulan bendera yang menunjukkan jenis status yang diminta. Ini harus satu atau beberapa hal berikut ini.
| Bendera | Makna |
|---|---|
| POLLPRI | Data prioritas dapat dibaca tanpa memblokir. Bendera ini tidak didukung oleh penyedia Microsoft Winsock. |
| POLLRDBAND | Data pita prioritas (di luar band) dapat dibaca tanpa memblokir. |
| POLLRDNORM | Data normal dapat dibaca tanpa memblokir. |
| POLLWRNORM | Data normal dapat ditulis tanpa memblokir. |
Bendera POLLIN didefinisikan sebagai kombinasi dari nilai bendera POLLRDNORM dan POLLRDBAND . Bendera POLLOUT didefinisikan sama dengan nilai bendera POLLWRNORM .
revents
Jenis: pendek
Sekumpulan bendera yang menunjukkan, setelah kembali dari panggilan fungsi WSAPoll , hasil kueri status. Ini bisa berupa kombinasi bendera berikut.
| Bendera | Deskripsi |
|---|---|
| POLLERR | Terjadi kesalahan. |
| POLLHUP | Koneksi berorientasi aliran terputus atau dibatalkan. |
| POLLNVAL | Soket yang tidak valid digunakan. |
| POLLPRI | Data prioritas dapat dibaca tanpa memblokir. Bendera ini tidak dikembalikan oleh penyedia Microsoft Winsock. |
| POLLRDBAND | Data pita prioritas (di luar band) dapat dibaca tanpa pemblokiran. |
| POLLRDNORM | Data normal dapat dibaca tanpa memblokir. |
| POLLWRNORM | Data normal dapat ditulis tanpa memblokir. |
Bendera POLLIN didefinisikan sebagai kombinasi dari nilai bendera POLLRDNORM dan POLLRDBAND . Bendera POLLOUT didefinisikan sama dengan nilai bendera POLLWRNORM .
Untuk soket yang tidak memenuhi kueri status, dan tidak memiliki kesalahan, anggota revent diatur ke nol saat pengembalian.
Keterangan
Struktur WSAPOLLFD didefinisikan pada Windows Vista dan yang lebih baru.
Struktur WSAPOLLFD digunakan oleh fungsi WSAPoll untuk menentukan status satu atau beberapa soket. Kumpulan soket yang statusnya diminta ditentukan dalam parameter fdarray , yang merupakan array struktur WSAPOLLFD . Aplikasi menetapkan bendera yang sesuai dalam peristiwa anggota struktur WSAPOLLFD untuk menentukan jenis status yang diminta untuk setiap soket yang sesuai. Fungsi WSAPoll mengembalikan status soket dalam anggota revent dari struktur WSAPOLLFD .
Jika anggota fd struktur WSAPOLLFD diatur ke nilai negatif, struktur diabaikan oleh panggilan fungsi WSAPoll , dan anggota revents dihapus saat dikembalikan. Ini berguna untuk aplikasi yang mempertahankan alokasi tetap untuk parameter fdarrayWSAPoll; aplikasi tersebut tidak perlu membuang-buang sumber daya yang memadai elemen array untuk entri yang tidak digunakan atau merealokasi memori. Tidak perlu menghapus anggota revents sebelum memanggil fungsi WSAPoll .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Header | winsock2.h |