Struttura WSAPOLLFD (winsock2.h)
La struttura WSAPOLLFD archivia le informazioni sul socket utilizzate dalla funzione WSAPoll .
Sintassi
typedef struct pollfd {
SOCKET fd;
SHORT events;
SHORT revents;
} WSAPOLLFD, *PWSAPOLLFD, *LPWSAPOLLFD;
Members
fd
Tipo: SOCKET
Identificatore del socket per il quale trovare lo stato. Questo parametro viene ignorato se impostato su un valore negativo. Vedere la sezione Osservazioni.
events
Tipo: short
Set di flag che indica il tipo di stato richiesto. Deve essere una o più delle seguenti.
| Contrassegno | Significato |
|---|---|
| POLLPRI | I dati con priorità possono essere letti senza blocco. Questo flag non è supportato dal provider Microsoft Winsock. |
| POLLRDBAND | I dati della banda di priorità (fuori banda) possono essere letti senza bloccare. |
| POLLRDNORM | I dati normali possono essere letti senza blocco. |
| POLLWRNORM | I dati normali possono essere scritti senza blocco. |
Il flag POLLIN è definito come combinazione dei valori del flag POLLRDNORM e POLLRDBAND . Il flag POLLOUT è definito come uguale al valore del flag POLLWRNORM .
revents
Tipo: short
Set di flag che indicano, al momento della restituzione dalla chiamata di funzione WSAPoll , i risultati della query di stato. Può essere una combinazione dei flag seguenti.
| Flag | Descrizione |
|---|---|
| POLLERR | un errore. |
| POLLHUP | Una connessione orientata al flusso è stata disconnessa o interrotta. |
| POLLNVAL | È stato usato un socket non valido. |
| POLLPRI | I dati con priorità possono essere letti senza blocco. Questo flag non viene restituito dal provider Microsoft Winsock. |
| POLLRDBAND | I dati della banda di priorità (fuori banda) possono essere letti senza blocco. |
| POLLRDNORM | I dati normali possono essere letti senza blocco. |
| POLLWRNORM | I dati normali possono essere scritti senza blocco. |
Il flag POLLIN è definito come combinazione dei valori del flag POLLRDNORM e POLLRDBAND . Il flag POLLOUT è definito come uguale al valore del flag POLLWRNORM .
Per i socket che non soddisfano la query di stato e non hanno errori, il membro revents viene impostato su zero al momento della restituzione.
Commenti
La struttura WSAPOLLFD è definita in Windows Vista e versioni successive.
La struttura WSAPOLLFD viene utilizzata dalla funzione WSAPoll per determinare lo stato di uno o più socket. Il set di socket per cui viene richiesto lo stato è specificato nel parametro fdarray , che è una matrice di strutture WSAPOLLFD . Un'applicazione imposta i flag appropriati nel membro eventi della struttura WSAPOLLFD per specificare il tipo di stato richiesto per ogni socket corrispondente. La funzione WSAPoll restituisce lo stato di un socket nel membro revents della struttura WSAPOLLFD .
Se il membro fd della struttura WSAPOLLFD è impostato su un valore negativo, la struttura viene ignorata dalla chiamata di funzione WSAPoll e il membro revents viene cancellato al momento della restituzione. Questo è utile per le applicazioni che mantengono un'allocazione fissa per il parametro fdarray di WSAPoll; tali applicazioni non devono sprecare risorse compattando gli elementi della matrice per le voci inutilizzate o la riallocazione della memoria. Non è necessario cancellare il membro revents prima di chiamare la funzione WSAPoll .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | winsock2.h |