Structure WSAPOLLFD (winsock2.h)
La structure WSAPOLLFD stocke les informations de socket utilisées par la fonction WSAPoll .
Syntaxe
typedef struct pollfd {
SOCKET fd;
SHORT events;
SHORT revents;
} WSAPOLLFD, *PWSAPOLLFD, *LPWSAPOLLFD;
Membres
fd
Type : SOCKET
Identificateur du socket pour lequel trouver status. Ce paramètre est ignoré s’il est défini sur une valeur négative. Consultez la section Notes.
events
Type : court
Ensemble d’indicateurs indiquant le type de status demandé. Il doit s’agir de l’un ou plusieurs des éléments suivants.
| Indicateur | Signification |
|---|---|
| POLLPRI | Les données de priorité peuvent être lues sans blocage. Cet indicateur n’est pas pris en charge par le fournisseur Microsoft Winsock. |
| POLLRDBAND | Les données de la bande de priorité (hors bande) peuvent être lues sans blocage. |
| POLLRDNORM | Les données normales peuvent être lues sans blocage. |
| POLLWRNORM | Les données normales peuvent être écrites sans blocage. |
L’indicateur POLLIN est défini comme la combinaison des valeurs d’indicateur POLLRDNORM et POLLRDBAND . L’indicateur POLLOUT est défini comme étant identique à la valeur de l’indicateur POLLWRNORM .
revents
Type : court
Ensemble d’indicateurs qui indiquent, au retour de l’appel de fonction WSAPoll, les résultats de la requête status. Cela peut être une combinaison des indicateurs suivants.
| Indicateur | Description |
|---|---|
| POLLERR | Une erreur s’est produite. |
| POLLHUP | Une connexion orientée flux a été déconnectée ou abandonnée. |
| POLLNVAL | Un socket non valide a été utilisé. |
| POLLPRI | Les données de priorité peuvent être lues sans blocage. Cet indicateur n’est pas retourné par le fournisseur Microsoft Winsock. |
| POLLRDBAND | Les données de la bande de priorité (hors bande) peuvent être lues sans blocage. |
| POLLRDNORM | Les données normales peuvent être lues sans blocage. |
| POLLWRNORM | Les données normales peuvent être écrites sans blocage. |
L’indicateur POLLIN est défini comme la combinaison des valeurs d’indicateur POLLRDNORM et POLLRDBAND . L’indicateur POLLOUT est défini comme étant identique à la valeur de l’indicateur POLLWRNORM .
Pour les sockets qui ne répondent pas à la requête status et qui n’ont pas d’erreur, le membre revents est défini sur zéro au retour.
Remarques
La structure WSAPOLLFD est définie sur Windows Vista et versions ultérieures.
La structure WSAPOLLFD est utilisée par la fonction WSAPoll pour déterminer la status d’un ou plusieurs sockets. L’ensemble de sockets pour lesquels status est demandé est spécifié dans le paramètre fdarray, qui est un tableau de structures WSAPOLLFD. Une application définit les indicateurs appropriés dans le membre d’événements de la structure WSAPOLLFD pour spécifier le type de status demandé pour chaque socket correspondant. La fonction WSAPoll retourne la status d’un socket dans le membre revents de la structure WSAPOLLFD.
Si le membre fd de la structure WSAPOLLFD est défini sur une valeur négative, la structure est ignorée par l’appel de fonction WSAPoll et le membre revents est effacé lors du retour. Cela est utile pour les applications qui maintiennent une allocation fixe pour le paramètre fdarray de WSAPoll ; ces applications n’ont pas besoin de gaspiller des ressources en compactant les éléments du tableau pour les entrées inutilisées ou en réaffectant la mémoire. Il n’est pas nécessaire d’effacer le membre revents avant d’appeler la fonction WSAPoll .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | winsock2.h |