儲存庫 vbox 的更動 38663

時間撮記:

2011-9-6 下午03:53:26 (13 年 以前)

作者:

vboxsync

訊息:

Devices/VMMDev: document VMMDevReq_GetDisplayChangeRequest[2]

位置:

trunk

檔案:

• include/VBox/VMMDev.h (修改) (1 筆差異)
• src/VBox/Devices/VMMDev/VMMDev.cpp (修改) (2 筆差異)

trunk/include/VBox/VMMDev.h

@@ -139 +139 @@
     VMMDevReq_ReportGuestInfo2           = 58, /* since version 3.2.0 */
     VMMDevReq_ReportGuestStatus          = 59, /* since version 3.2.8 */
+    /**
+     * Retrieve a display resize request sent by the host using
+     * @a IDisplay:setVideoModeHint.  Deprecated.
+     *
+     * Similar to @a VMMDevReq_GetDisplayChangeRequest2, except that it only
+     * considers host requests sent for the first virtual display.  This guest
+     * request should not be used in new guest code, and the results are
+     * undefined if a guest mixes calls to this and
+     * @a VMMDevReq_GetDisplayChangeRequest2.
+     */
     VMMDevReq_GetDisplayChangeRequest    = 51,
     VMMDevReq_VideoModeSupported         = 52,
     VMMDevReq_GetHeightReduction         = 53,
+    /**
+     * Retrieve a display resize request sent by the host using
+     * @a IDisplay:setVideoModeHint.
+     *
+     * Queries a display resize request sent from the host.  If the
+     * @a eventAck member is sent to true and there is an unqueried
+     * request available for one of the virtual display then that request will
+     * be returned.  If several displays have unqueried requests the lowest
+     * numbered display will be chosen first.  Only the most recent unseen
+     * request for each display is remembered.
+     * If @a eventAck is set to false, the last host request queried with
+     * @a eventAck set is resent, or failing that the most recent received from
+     * the host.  If no host request was ever received then all zeros are
+     * returned.
+     */
     VMMDevReq_GetDisplayChangeRequest2   = 54,
     VMMDevReq_ReportGuestCapabilities    = 55,

trunk/src/VBox/Devices/VMMDev/VMMDev.cpp

@@ -976 +976 @@
 
         /*
-         * Get display change request
+         * Retrieve a display resize request sent by the host using
+         * @a IDisplay:setVideoModeHint.  Deprecated.
+         * See documentation in VMMDev.h.
+         */
+        /**
+         * @todo It looks like a multi-monitor guest which only uses
+         *        @a VMMDevReq_GetDisplayChangeRequest (not the *2 version)
+         *        will get into a @a VMMDEV_EVENT_DISPLAY_CHANGE_REQUEST event
+         *        loop if it tries to acknowlege host requests for additional
+         *        monitors.  Should the loop which checks for those requests
+         *        be removed?
          */
         case VMMDevReq_GetDisplayChangeRequest:
@@ -1039 +1049 @@
         }
 
+        /*
+         * Retrieve a display resize request sent by the host using
+         * @a IDisplay:setVideoModeHint.
+         * See documentation in VMMDev.h.
+         */
         case VMMDevReq_GetDisplayChangeRequest2:
         {