Changeset 74517 in vbox for trunk/include/iprt

Timestamp:

Sep 28, 2018 11:24:47 AM (6 years ago)

Author:

vboxsync

Message:

NEM/win: Updates for new builds. bugref:9044

File:

• trunk/include/iprt/nt/vid.h (modified) (3 diffs)

trunk/include/iprt/nt/vid.h

@@ -101 +101 @@
     HV_VP_INDEX         iCpu;
     uint32_t            fFlags;         /**< VID_MSHAGN_F_GET_XXX*/
-    uint32_t            cMillies;
+    uint32_t            cMillies;       /**< Not present in build 17758 as the API changed to always to infinite waits. */
 } VID_IOCTL_INPUT_MESSAGE_SLOT_HANDLE_AND_GET_NEXT;
 /** Pointer to input for VidMessageSlotHandleAndGetNext. */
@@ -117 +117 @@
  * subject to NtAlertThread side effects. */
 #define VID_MSHAGN_F_HANDLE_MESSAGE     RT_BIT_32(1)
+/** Cancel VP execution (no other bit set).
+ * @since about build 17758. */
+#define VID_MSHAGN_F_CANCEL             RT_BIT_32(2)
 /** @} */
 
@@ -186 +189 @@
  * @param   hPartition  The partition handle.
  * @param   iCpu        The CPU to wait-and-get messages for.
- * @param   fFlags      Flags. At least one of the two flags must be set:
- *                          - VID_MSHAGN_F_GET_NEXT_MESSAGE (bit 0)
- *                          - VID_MSHAGN_F_HANDLE_MESSAGE (bit 1)
- * @param   cMillies    The timeout, presumably in milliseconds.
+ * @param   fFlags      Flags, VID_MSHAGN_F_XXX.
+ *
+ *                      When starting or resuming execution, at least one of
+ *                      VID_MSHAGN_F_GET_NEXT_MESSAGE (bit 0) and
+ *                      VID_MSHAGN_F_HANDLE_MESSAGE (bit 1) must be set.
+ *
+ *                      When cancelling execution only VID_MSHAGN_F_CANCEL (big 2)
+ *                      must be set.
+ *
+ * @param   cMillies    The timeout, presumably in milliseconds.  This parameter
+ *                      was dropped about build 17758.
  *
  * @todo    Would be awfully nice if someone at Microsoft could hit at the
  *          flags here.
- * @note
  */
 DECLIMPORT(BOOL) VIDAPI VidMessageSlotHandleAndGetNext(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu,