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.

All labels observed (1)

Label Occurrences
WSAWaitForMultipleEvents canonical 2

How this entity was disambiguated

Statements (47)

Predicate Object
instanceOf Windows Sockets 2 API function
Winsock function
abandonedReturn WSA_WAIT_IO_COMPLETION
alertableFlag fAlertable controls APC and I/O completion wakeups
callingConvention WINAPI
category network event wait function
synchronization function
definedIn Winsock 2
dll Ws2_32.dll
errorReporting uses WSAGetLastError for extended error information
failureReturn WSA_WAIT_FAILED
header winsock2.h
introducedIn Winsock 2 specification
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
platform Microsoft Windows
linked to: Windows
purpose waits for one or more network event objects to become signaled
relatedFunction WSACreateEvent
WSAEnumNetworkEvents
WSAEventSelect
WSAResetEvent
WSASetEvent
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

How these facts were elicited

Referenced by (2)

Full triples — surface form annotated when it differs from this entity's canonical label.

Ws2_32 exportsFunction WSAWaitForMultipleEvents
WSAEventSelect usedWith WSAWaitForMultipleEvents