Changeset 67314 in vbox for trunk/src/VBox

Timestamp:

Jun 9, 2017 10:06:59 AM (8 years ago)

Author:

vboxsync

Message:

bugref:8533: Additions/x11: fully support VMSVGA
Add VbglR3AcquireGuestCaps() to the R3 guest library.

This change creates a guest library wrapper for the
VBOXGUEST_IOCTL_GUEST_CAPS_ACQUIRE VBoxGuest driver IoCtl which was added to
allow several instances of VBoxTray to run at once for different users in
Windows guests, but only one at a given time to receive display change and
seamless notifications. VBoxClient --vmsvga can use this to prevent the
privileged kernel mode-setting daemon version and the X11 client version
listening for display change notifications at the same time.

File:

• trunk/src/VBox/Additions/common/VBoxGuestLib/VBoxGuestR3LibMisc.cpp (modified) (1 diff)

trunk/src/VBox/Additions/common/VBoxGuestLib/VBoxGuestR3LibMisc.cpp

@@ -69 +69 @@
 
 /**
+ * Acquire capabilities to report to the host.  The capabilities which can be
+ * acquired are the same as those reported by @a VbglR3SetGuestCaps, and once
+ * a capability has been acquired once is is switched to "acquire mode" and can
+ * no longer be set using @a VbglR3SetGuestCaps.  Capabilities can also be
+ * switched to acquire mode without actually being acquired.  A client can not
+ * acquire a capability which has been acquired and not released by another
+ * client.  Capabilities acquired are automatically released on session
+ * termination.
+ *
+ * @returns IPRT status code
+ * @returns VERR_RESOURCE_BUSY and acquires nothing if another client has
+ *          acquired and not released at least one of the @a fOr capabilities
+ * @param   fOr      Capabilities to acquire or to switch to acquire mode
+ * @param   fNot     Capabilities to release
+ * @param   fConfig  if set, capabilities in @a fOr are switched to acquire mode
+ *                   but not acquired, and @a fNot is ignored.
+ */
+VBGLR3DECL(int) VbglR3AcquireGuestCaps(uint32_t fOr, uint32_t fNot, bool fConfig)
+{
+    VBoxGuestCapsAquire Info;
+    int rc;
+
+    Info.u32OrMask = fOr;
+    Info.u32NotMask = fNot;
+    Info.enmFlags = fConfig ? VBOXGUESTCAPSACQUIRE_FLAGS_CONFIG_ACQUIRE_MODE
+                            : VBOXGUESTCAPSACQUIRE_FLAGS_NONE;
+    rc = vbglR3DoIOCtl(VBOXGUEST_IOCTL_GUEST_CAPS_ACQUIRE, &Info, sizeof(Info));
+    if (RT_FAILURE(rc))
+        return rc;
+    return Info.rc;
+}
+
+
+/**
  * Query the session ID of this VM.
  *