Structure WSAPOLLFD (winsock2.h)

Article
08/27/2023

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.

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

Voir aussi

Share via