Changeset 27318 in vbox for trunk/src/VBox/Additions/common/VBoxGuestLib

Timestamp:

Mar 12, 2010 10:27:04 AM (15 years ago)

Author:

vboxsync

Message:

VBoxGuestR3LibSeamless.cpp: Initialize (poison) the output members of the request structure. Doxygen @retval is for explaining @returns.

File:

• trunk/src/VBox/Additions/common/VBoxGuestLib/VBoxGuestR3LibSeamless.cpp (modified) (4 diffs)

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

@@ -58 +58 @@
  * Wait for a seamless mode change event.
  *
- * @returns IPRT status value
- * @retval  pMode on success, the seamless mode to switch into (i.e. disabled, visible region
- *                or host window)
+ * @returns IPRT status value.
+ * @param[out] pMode    On success, the seamless mode to switch into (i.e.
+ *                      disabled, visible region or host window).
  */
 VBGLR3DECL(int) VbglR3SeamlessWaitEvent(VMMDevSeamlessMode *pMode)
@@ -84 +84 @@
             /* get the seamless change request */
             vmmdevInitRequest(&seamlessChangeRequest.header, VMMDevReq_GetSeamlessChangeRequest);
+            seamlessChangeRequest.mode = (VMMDevSeamlessMode)-1;
             seamlessChangeRequest.eventAck = VMMDEV_EVENT_SEAMLESS_MODE_CHANGE_REQUEST;
             rc = vbglR3GRPerform(&seamlessChangeRequest.header);
@@ -101 +102 @@
  * Request the last seamless mode switch from the host again.
  *
- * @returns IPRT status value
- * @retval  pMode on success, the seamless mode that was switched into (i.e.
- *          disabled, visible region or host window)
+ * @returns IPRT status value.
+ * @param[out] pMode    On success, the seamless mode that was switched
+ *                      into (i.e. disabled, visible region or host window).
  */
 VBGLR3DECL(int) VbglR3SeamlessGetLastEvent(VMMDevSeamlessMode *pMode)
 {
+    VMMDevSeamlessChangeRequest seamlessChangeRequest;
     int rc;
 
@@ -112 +114 @@
     AssertPtrReturn(pMode, VERR_INVALID_PARAMETER);
 #endif
-    VMMDevSeamlessChangeRequest seamlessChangeRequest;
 
     /* get the seamless change request */
     vmmdevInitRequest(&seamlessChangeRequest.header, VMMDevReq_GetSeamlessChangeRequest);
+    seamlessChangeRequest.mode = (VMMDevSeamlessMode)-1;
     seamlessChangeRequest.eventAck = VMMDEV_EVENT_SEAMLESS_MODE_CHANGE_REQUEST;
     rc = vbglR3GRPerform(&seamlessChangeRequest.header);