Changeset 100655 in vbox for trunk/include

Timestamp:

Jul 19, 2023 4:06:24 PM (17 months ago)

Author:

vboxsync

Message:

Shared Clipboard/VRDE: Integrated the logic of ShClSvcIsBackendActive() in ShClSvcReportFormats(), so that the specific backends don't need to be in charge for that anymore. Renamed VBOX_CLIPBOARD_EXT_FN_FORMAT_ANNOUNCE -> VBOX_CLIPBOARD_EXT_FN_FORMAT_REPORT_TO_HOST to emphasize its usage. Added VBOX_CLIPBOARD_EXT_FN_FORMAT_REPORT_TO_GUEST; see comment for details.

The whole concept of VRDE being a (one and only) service extension nowadays isn't optimal anymore and needs to be replaced with a more generic mechanism, which is out of this scope for this task. So just adapt this as needed and keep the current way.

bugref:9437

File:

• trunk/include/VBox/HostServices/VBoxClipboardExt.h (modified) (1 diff)

trunk/include/VBox/HostServices/VBoxClipboardExt.h

@@ -47 +47 @@
 
 /** Sets (or unsets) a clipboard extension callback. */
-#define VBOX_CLIPBOARD_EXT_FN_SET_CALLBACK         (0)
-/** The guest announces clipboard formats to the extension. */
-#define VBOX_CLIPBOARD_EXT_FN_FORMAT_ANNOUNCE      (1)
+#define VBOX_CLIPBOARD_EXT_FN_SET_CALLBACK               (0)
+/** The guest reports clipboard formats to the extension. */
+#define VBOX_CLIPBOARD_EXT_FN_FORMAT_REPORT_TO_HOST      (1)
+/** The clipboard service wants to report formats to the guest. */
+#define VBOX_CLIPBOARD_EXT_FN_FORMAT_REPORT_TO_GUEST     (2)
 /** The clipboard service requests clipboard data from the extension. */
-#define VBOX_CLIPBOARD_EXT_FN_DATA_READ            (2)
+#define VBOX_CLIPBOARD_EXT_FN_DATA_READ                  (3)
 /** The clipboard service writes clipboard data to the extension. */
-#define VBOX_CLIPBOARD_EXT_FN_DATA_WRITE           (3)
+#define VBOX_CLIPBOARD_EXT_FN_DATA_WRITE                 (4)
 /** The clipboard service announces an error to the extension. */
-#define VBOX_CLIPBOARD_EXT_FN_ERROR                (4)
+#define VBOX_CLIPBOARD_EXT_FN_ERROR                      (5)
 
 typedef DECLCALLBACKTYPE(int, FNSHCLEXTCALLBACK,(uint32_t u32Function, uint32_t u32Format, void *pvData, uint32_t cbData));