This function is blocking: if there's no pending event then it will wait
until an event is received. After this function returns (and no error
occured), the event object is always valid and filled properly. This
function is typically used when you have a thread that is dedicated to
events handling: you want to make this thread sleep as long as no new
event is received.
Wait for an event and return it.
This function is blocking: if there's no pending event then it will wait until an event is received. After this function returns (and no error occured), the event object is always valid and filled properly. This function is typically used when you have a thread that is dedicated to events handling: you want to make this thread sleep as long as no new event is received.