Changeset 82487 in vbox for trunk/include

Timestamp:

Dec 7, 2019 3:37:03 AM (5 years ago)

Author:

vboxsync

Message:

VBox/VBoxGuestLib.h: Save four padding bytes in VBGLR3SHCLCMDCTX and remove the incorrect note regarding updating initializers (I couldn't find any). bugref:9437

File:

• trunk/include/VBox/VBoxGuestLib.h (modified) (2 diffs)

trunk/include/VBox/VBoxGuestLib.h

@@ -588 +588 @@
 
 /**
- * Structure containing the context required for
- * either retrieving or sending a HGCM shared clipboard
+ * The context required for either retrieving or sending a HGCM shared clipboard
  * commands from or to the host.
- *
- * Note: Do not change parameter order without also
- *       adapting all structure initializers.
  */
 typedef struct VBGLR3SHCLCMDCTX
@@ -601 +597 @@
      *        Use a union for the HGCM stuff then. */
 
+    /** IN/OUT: Context ID to retrieve or to use. */
+    uint64_t                  uContextID;
     /** IN: HGCM client ID to use for communication. */
     uint32_t                  uClientID;
-    /** IN/OUT: Context ID to retrieve or to use. */
-    uint64_t                  uContextID;
     /** IN: Maximum chunk size (in bytes). */
     uint32_t                  cbChunkSize;
+    /** IN: Host feature flags (of type VBOX_SHCL_HF_XXX). */
+    uint64_t                  fHostFeatures;
     /** Flag indicating whether to use the legacy protocol (<= VBox 6.1) or not.
      *  This is determined in VbglR3ClipboardConnectEx(). */
     bool                      fUseLegacyProtocol;
-    /** IN: Host feature flags (of type VBOX_SHCL_HF_XXX). */
-    uint64_t                  fHostFeatures;
-    /** OUT: Number of parameters retrieved. */
+    /** OUT: Number of parameters retrieved.
+     * @todo r=bird: s/uNumParms/cParms/ !! */
     uint32_t                  uNumParms;
 #  ifdef VBOX_WITH_SHARED_CLIPBOARD_TRANSFERS