Index: /trunk/src/VBox/Frontends/VirtualBox/src/globals/COMDefs.h
===================================================================
--- /trunk/src/VBox/Frontends/VirtualBox/src/globals/COMDefs.h (revision 30309)
+++ /trunk/src/VBox/Frontends/VirtualBox/src/globals/COMDefs.h (revision 30310)
@@ -734,5 +734,9 @@
bool operator!= (const CInterface &that) const { return mIface != that.mIface; }
-protected:
+/**
+ * @todo: rethink if we'll ever need 'protected' back, removed to allow mIface access in rather
+ * nontrivial inheritance situations, see 'friend wrappers' code in COMWrappers.xsl
+ */
+//protected:
mutable I *mIface;
Index: /trunk/src/VBox/Main/Makefile.kmk
===================================================================
--- /trunk/src/VBox/Main/Makefile.kmk (revision 30309)
+++ /trunk/src/VBox/Main/Makefile.kmk (revision 30310)
@@ -319,4 +319,5 @@
BIOSSettingsImpl.cpp \
HostPower.cpp \
+ EventImpl.cpp \
$(if $(VBOX_WITH_VRDP),VRDPServerImpl.cpp,) \
$(if $(VBOX_WITH_XPCOM),xpcom/server.cpp,) \
@@ -645,4 +646,5 @@
AudioSnifferInterface.cpp \
VMMDevInterface.cpp \
+ EventImpl.cpp \
$(VBOX_XML_SCHEMADEFS_CPP)
VBoxC_SOURCES.win = \
Index: /trunk/src/VBox/Main/idl/VirtualBox.xidl
===================================================================
--- /trunk/src/VBox/Main/idl/VirtualBox.xidl (revision 30309)
+++ /trunk/src/VBox/Main/idl/VirtualBox.xidl (revision 30310)
@@ -14546,4 +14546,277 @@
+
+
+
+ Type of an event.
+
+
+
+
+ Invalid event.
+
+
+
+
+
+ Wildcard for all events. Events of this type are never delivered, and only used in
+ registerListener() call to simplify registration.
+
+
+
+
+
+ Wildcard for all machine events. Events of this type are never delivered, and only used in
+ registerListener() call to simplify registration.
+
+
+
+
+
+ IVirtualBoxCallback::onMachineStateChange
+
+
+
+
+ IVirtualBoxCallback::onMachineDataChange
+
+
+
+
+ IVirtualBoxCallback::onExtraDataChange
+
+
+
+
+
+
+
+ Event source. Generally, any object which could generate events can be an event source,
+ or aggregate one. To simplify using one-way protocols, such as webservices running on top of HTTP(S),
+ event source can work with listeners in either active or passive mode. In active mode it's up to
+ IEventSource implementation to call handleEvent(), in passive mode event source keeps track of
+ pending events for each listener and returns available events on demand.
+
+
+
+
+ Register an event listener.
+
+
+ Listener to register.
+
+
+
+ Event types listener is interested in. One can use wildcards like Any -
+ VBoxEventType::Any to specify wildcards.
+
+
+
+
+ Which mode this listener shall function in.
+ If in active mode, IEventListener's handleEvent() is called directly.
+ If in passive mode - for this IEventListener internal event queue is created.
+ When next event comes, it's added to queues for all interested registered passive
+ listeners. It's up to external code to call listener's handleEvent() then.
+ When done with event, it shall call source's eventComplete().
+
+
+
+
+
+
+ Unregister an event listener. If listener is passive, and some waitable events are still
+ in queue they are marked as processed automatically.
+
+
+ Listener to unregister.
+
+
+
+
+
+ Fire an event for this source.
+
+
+ Event to deliver.
+
+
+
+ Timeout to wait until event processed in ms (if event is waitable),
+ 0 - no wait, -1 - forever until delivered.
+
+
+
+ true if an event was delivered to all targets, or is non-waitable.
+
+
+
+
+
+ Get events from this peer's event queue (for passive mode). Consumer's implementation
+ must call listener's handleEvent() once event is available.
+
+
+ Which listener get data for.
+
+
+ Timeout to wait until event available in ms, 0 - no wait, -1 - forever until available.
+
+
+ Event retrieved, or null if none available.
+
+
+
+
+
+ Must be called for waitable events when particular listener finished event processing.
+ When all listeners who this event was aimed to call eventProcessed() event source
+ can call event's setProcessed().
+
+
+ Which listener processed event.
+
+
+ Which event.
+
+
+
+
+
+
+
+ Event listener. Event listener can work in either active, or passive mode, depending on the way it's registered.
+
+
+
+
+ Handle event callback (called directly by IEventSource in active mode, or by event processor thread
+ in passive mode).
+
+
+ Event available.
+
+
+
+
+
+
+ Generic event, aiming to replace callbacks mechanism.
+
+
+
+ Event type.
+
+
+
+
+
+ Source of this event.
+
+
+
+
+
+ If we can wait for this event being processed. If false, waitProcessed() returns immediately,
+ and setProcessed() doesn't make sense. Non-waitable events are generally better performing,
+ as no additional overhead associated with waitability imposed.
+ Waitable events are needed when some need to be able to wait for particular event processed,
+ for example for vetoable changes, or if event refers to some resource which need to be kept immutable
+ until all consumers confirmed events.
+
+
+
+
+
+ Called to mark the moment when this event is considered processed.
+
+
+
+
+
+ Wait until time outs, or this event is processed. Event must be waitable for this operation to have
+ described semantics, for non-waitable returns true immediately.
+
+
+ Timeout to wait until event processed in ms, 0 - no wait, -1 - forever until processed.
+
+
+ If this event was processed before timeout.
+
+
+
+
+
+ Machine state change event.
+
+
+ ID of the machine this event relates to.
+
+
+
+ New execution state.
+
+
+
+
+
+ Any of the settings of the given machine has changed.
+
+
+
+ ID of the machine this event relates to.
+
+
+
+
+
+
+ Notification when machine specific or global extra data
+ has changed.
+
+
+
+ ID of the machine this event relates to.
+ Null for global extra data changes.
+
+
+
+
+ Extra data key that has changed.
+
+
+
+
+ Extra data value for the given key.
+
+
+
+
+
+
+
+