WSAPOLLFD-Struktur (winsock2.h)

Artikel
08/27/2023

Die WSAPOLLFD-Struktur speichert Socketinformationen, die von der WSAPoll-Funktion verwendet werden.

Syntax

typedef struct pollfd {
  SOCKET fd;
  SHORT  events;
  SHORT  revents;
} WSAPOLLFD, *PWSAPOLLFD, *LPWSAPOLLFD;

Member

fd

Typ: SOCKET

Der Bezeichner des Sockets, für den status gefunden werden soll. Dieser Parameter wird ignoriert, wenn er auf einen negativen Wert festgelegt ist. Siehe Hinweise.

events

Typ: short

Eine Reihe von Flags, die den Typ der angeforderten status angeben. Dies muss mindestens einer der folgenden Sein.

Flag	Bedeutung
POLLPRI	Prioritätsdaten können ohne Blockierung gelesen werden. Dieses Flag wird vom Microsoft Winsock-Anbieter nicht unterstützt.
POLLRDBAND	Prioritätsbanddaten (Out-of-Band) können ohne Blockierung gelesen werden.
POLLRDNORM	Normale Daten können ohne Blockierung gelesen werden.
POLLWRNORM	Normale Daten können ohne Blockierung geschrieben werden.

Das POLLIN-Flag wird als Kombination aus den Flagwerten POLLRDNORM und POLLRDBAND definiert. Das POLLOUT-Flag ist mit dem Wert des POLLWRNORM-Flags identisch.

revents

Typ: short

Eine Reihe von Flags, die bei Rückgabe des WSAPoll-Funktionsaufrufs die Ergebnisse der status Abfrage angeben. Dies kann eine Kombination der folgenden Flags sein.

Flag	Beschreibung
POLLERR	Es ist ein Fehler aufgetreten.
POLLHUP	Eine streamorientierte Verbindung wurde entweder getrennt oder abgebrochen.
POLLNVAL	Ein ungültiger Socket wurde verwendet.
POLLPRI	Prioritätsdaten können ohne Blockierung gelesen werden. Dieses Flag wird vom Microsoft Winsock-Anbieter nicht zurückgegeben.
POLLRDBAND	Prioritätsbanddaten (Out-of-Band) können ohne Blockierung gelesen werden.
POLLRDNORM	Normale Daten können ohne Blockierung gelesen werden.
POLLWRNORM	Normale Daten können ohne Blockierung geschrieben werden.

Das POLLIN-Flag wird als Kombination aus den Flagwerten POLLRDNORM und POLLRDBAND definiert. Das POLLOUT-Flag ist mit dem Wert des POLLWRNORM-Flags identisch.

Für Sockets, die die status Abfrage nicht erfüllen und keinen Fehler aufweisen, wird das revents-Element bei der Rückgabe auf Null festgelegt.

Hinweise

Die WSAPOLLFD-Struktur wird unter Windows Vista und höher definiert.

Die WSAPOLLFD-Struktur wird von der WSAPoll-Funktion verwendet, um die status eines oder mehrerer Sockets zu bestimmen. Der Satz von Sockets, für die status angefordert wird, wird im Fdarray-Parameter angegeben, bei dem es sich um ein Array von WSAPOLLFD-Strukturen handelt. Eine Anwendung legt die entsprechenden Flags im Ereignismember der WSAPOLLFD-Struktur fest, um den Typ der für jeden entsprechenden Socket angeforderten status anzugeben. Die WSAPoll-Funktion gibt die status eines Sockets im revents-Member der WSAPOLLFD-Struktur zurück.

Wenn der fd-Member der WSAPOLLFD-Struktur auf einen negativen Wert festgelegt ist, wird die Struktur vom WSAPoll-Funktionsaufruf ignoriert, und der Revents-Member wird bei der Rückgabe gelöscht. Dies ist nützlich für Anwendungen, die eine feste Zuordnung für den fdarray-Parameter von WSAPoll beibehalten; Solche Anwendungen müssen keine Ressourcen verschwenden, die Elemente des Arrays komprimieren, um ungenutzte Einträge zu verwenden oder Speicher neu zuzuordnen. Es ist nicht erforderlich, das Revents-Element vor dem Aufrufen der WSAPoll-Funktion zu löschen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	winsock2.h

Weitere Informationen