Changeset 93499 in vbox for trunk/include/VBox/GuestHost

Timestamp:

Jan 31, 2022 1:59:38 PM (3 years ago)

Author:

vboxsync

Message:

Shared Clipboard: Implemented backend callbacks and a dedicated backend context, together with a new testcase which mocks HGCM to also test the guest-side clipboard code (disabled by default for now). Work in progress, only tested on Linux so far [Doxygen fix].

File:

• trunk/include/VBox/GuestHost/SharedClipboard.h (modified) (3 diffs)

trunk/include/VBox/GuestHost/SharedClipboard.h

@@ -259 +259 @@
      * @param   pCtx            Opaque context pointer for the glue code.
      * @param   fFormats        The formats available.
+     * @param   pvUser          Implementation-dependent pointer to data for fullfilling the request.
+     *                          Optional and can be NULL.
      */
     DECLCALLBACKMEMBER(int, pfnReportFormats, (PSHCLCONTEXT pCtx, SHCLFORMATS fFormats, void *pvUser));
@@ -320 +322 @@
      * Callback for sending clipboard data to the destination.
      *
-     * @note On X11:
-     *         (see @a rcCompletion)
-     *
      * @returns VBox status code.
      * @param   pCtx            Opaque context pointer for the glue code.
@@ -328 +327 @@
      * @param   cb              The size of the data in @a pv.
      * @param   pvUser          Implementation-dependent pointer to data for fullfilling the request.
-     *                          Optional and can be NULL.
+     *                          Optional and can be NUL
+     *                          On X11: Of type PSHCLX11READDATAREQ.
      */
     DECLCALLBACKMEMBER(int, pfnOnSendDataToDest, (PSHCLCONTEXT pCtx, void *pv, uint32_t cb, void *pvUser));