WSAPOLLFD-Struktur (winsock2.h)
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 |