Changeset 34820 in vbox for trunk/src/VBox

Timestamp:

Dec 8, 2010 8:22:37 AM (14 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

68631

Message:

Main: docs update on IEventListener::handleEvent

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (1 diff)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -15105 +15105 @@
     <method name="handleEvent">
       <desc>
-        Handle event callback (called directly by IEventSource in active mode, or could be
-        called by event processor thread in passive mode).
+        Handle event callback. It never called for passive listeners, and only make sense
+        to implement in active listener. Once handleEvent() on all active listeners is called,
+        and all passive listeners acknowledged event processing with IEventSource::eventProcessed()
+        event is marked as processed, so that IEvent::waitProcessed() returns immediately.
       </desc>
       <param name="event" type="IEvent" dir="in">