WSAWaitForMultipleEvents
E724291
WSAWaitForMultipleEvents is a Winsock 2 API function that waits for one or more network event objects to become signaled, enabling efficient event-driven socket I/O on Windows.
Statements (47)
| Predicate | Object |
|---|---|
| instanceOf |
Windows Sockets 2 API function
ⓘ
Winsock function ⓘ |
| abandonedReturn | WSA_WAIT_IO_COMPLETION NERFINISHED ⓘ |
| alertableFlag | fAlertable controls APC and I/O completion wakeups ⓘ |
| callingConvention | WINAPI ⓘ |
| category |
network event wait function
ⓘ
synchronization function ⓘ |
| definedIn | Winsock 2 NERFINISHED ⓘ |
| dll | Ws2_32.dll ⓘ |
| errorReporting | uses WSAGetLastError for extended error information ⓘ |
| failureReturn | WSA_WAIT_FAILED ⓘ |
| header | winsock2.h NERFINISHED ⓘ |
| introducedIn | Winsock 2 specification NERFINISHED ⓘ |
| languageBinding |
C
ⓘ
C++ ⓘ |
| library | Ws2_32.lib ⓘ |
| maxEvents | WSA_MAXIMUM_WAIT_EVENTS ⓘ |
| namespace | global C API ⓘ |
| parameter |
BOOL fAlertable
ⓘ
BOOL fWaitAll ⓘ DWORD cEvents ⓘ DWORD dwTimeout ⓘ const WSAEVENT FAR * lphEvents ⓘ |
| partOf | Windows Sockets 2 API NERFINISHED ⓘ |
| platform |
Windows
ⓘ
surface form:
Microsoft Windows
|
| purpose | waits for one or more network event objects to become signaled ⓘ |
| relatedFunction |
WSACreateEvent
NERFINISHED
ⓘ
WSAEnumNetworkEvents NERFINISHED ⓘ WSAEventSelect NERFINISHED ⓘ WSAResetEvent NERFINISHED ⓘ WSASetEvent NERFINISHED ⓘ |
| replaces | select in some event-driven designs ⓘ |
| requires | successful WSAStartup initialization ⓘ |
| returnType | DWORD ⓘ |
| similarTo | WaitForMultipleObjects but for WSAEVENT handles ⓘ |
| successReturn | index of the signaled event offset by WSA_WAIT_EVENT_0 ⓘ |
| supports |
asynchronous network operations
ⓘ
event-driven socket I/O ⓘ overlapped I/O ⓘ |
| threading | can be used from multithreaded applications ⓘ |
| timeoutBehavior | returns WSA_WAIT_TIMEOUT when timeout elapses ⓘ |
| timeoutReturn | WSA_WAIT_TIMEOUT ⓘ |
| timeoutUnit | milliseconds ⓘ |
| usagePattern | commonly used in loops to monitor multiple sockets ⓘ |
| usedFor | efficient multiplexing of multiple sockets on Windows ⓘ |
| usesHandleType | WSAEVENT ⓘ |
| waitAllFlag | fWaitAll controls whether all events must be signaled ⓘ |
Referenced by (1)
Full triples — surface form annotated when it differs from this entity's canonical label.