www.vmware.com
18
C API Reference Guide
RC1
Vix_PumpEvents
Function Signature
void
Vix_PumpEvents(VixHandle hostHandle,
VixPumpEventsOptions options);
Parameters
Results
None.
Notes
• This option is designed for client applications that want to receive events on
only one thread, such as a thread that manages the user interface. In this case,
open the local host handle with the VIX_HOSTOPTION_USE_EVENT_PUMP
option, and call Vix_PumpEvents() in the main event loop. If you fail to call
Vix_PumpEvents(), then VIX asynchronous actions will not execute.
• If you do not open your local host with the
VIX_HOSTOPTION_USE_EVENT_PUMP option, then calling
Vix_PumpEvents() has no effect.
If you do not open your local host with the
VIX_HOSTOPTION_USE_EVENT_PUMP option, then the C API creates a
small pool of threads for executing asynchronous operations. Events may be
posted from those worker threads, so your code must be thread-safe.
handle The handle to the local host object.
options Must be 0.
