Changeset 71136 in vbox for trunk/include/iprt/nt

Timestamp:

Feb 27, 2018 1:17:36 PM (7 years ago)

Author:

vboxsync

Message:

SUPDrv,VMM/NEM/win: Abstracted kernel I/O control work in SUPDrv, currently only implemented & needed on windows. Made first I/O control call to VID from ring-0. bugref:9044

File:

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

trunk/include/iprt/nt/vid.h

@@ -108 +108 @@
 typedef VID_IOCTL_INPUT_MESSAGE_SLOT_HANDLE_AND_GET_NEXT const *PCVID_IOCTL_INPUT_MESSAGE_SLOT_HANDLE_AND_GET_NEXT;
 
-
-RT_C_DECLS_BEGIN
-
-/** Calling convention. */
-#ifndef WINAPI
-# define VIDAPI __stdcall
-#else
-# define VIDAPI WINAPI
-#endif
-
-/** Partition handle. */
-#ifndef WINAPI
-typedef void *VID_PARTITION_HANDLE;
-#else
-typedef HANDLE VID_PARTITION_HANDLE;
-#endif
-
-/**
- * Gets the partition ID.
- *
- * The partition ID is the numeric identifier used when making hypercalls to the
- * hypervisor.
- */
-DECLIMPORT(BOOL) VIDAPI VidGetHvPartitionId(VID_PARTITION_HANDLE hPartition, HV_PARTITION_ID *pidPartition);
-
-/**
- * Starts asynchronous execution of a virtual CPU.
- */
-DECLIMPORT(BOOL) VIDAPI VidStartVirtualProcessor(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu);
-
-/**
- * Stops the asynchronous execution of a virtual CPU.
- *
- * @retval ERROR_VID_STOP_PENDING if busy with intercept, check messages.
- */
-DECLIMPORT(BOOL) VIDAPI VidStopVirtualProcessor(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu);
-
-/**
- * WHvCreateVirtualProcessor boils down to a call to VidMessageSlotMap and
- * some internal WinHvPlatform state fiddling.
- *
- * Looks like it maps memory and returns the pointer to it.
- * VidMessageSlotHandleAndGetNext is later used to wait for the next message and
- * put (??) it into that memory mapping.
- *
- * @returns Success indicator (details in LastStatusValue and LastErrorValue).
- *
- * @param   hPartition  The partition handle.
- * @param   pOutput     Where to return the pointer to the message memory
- *                      mapping.  The CPU index is also returned here.
- * @param   iCpu        The CPU to wait-and-get messages for.
- */
-DECLIMPORT(BOOL) VIDAPI VidMessageSlotMap(VID_PARTITION_HANDLE hPartition, PVID_MAPPED_MESSAGE_SLOT pOutput, HV_VP_INDEX iCpu);
-
-/**
- * This is used by WHvRunVirtualProcessor to wait for the next exit msg.
- *
- * The message appears in the memory mapping returned by VidMessageSlotMap.
- *
- * @returns Success indicator (details only in LastErrorValue - LastStatusValue
- *          is not set).
- * @retval  STATUS_TIMEOUT for STATUS_TIMEOUT as well as STATUS_USER_APC and
- *          STATUS_ALERTED.
- *
- * @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.
- *
- * @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,
-                                                       uint32_t fFlags, uint32_t cMillies);
 /** @name VID_MSHAGN_F_GET_XXX - Flags for VidMessageSlotHandleAndGetNext
  * @{ */
@@ -196 +119 @@
 /** @} */
 
+
+#ifdef IN_RING3
+RT_C_DECLS_BEGIN
+
+/** Calling convention. */
+#ifndef WINAPI
+# define VIDAPI __stdcall
+#else
+# define VIDAPI WINAPI
+#endif
+
+/** Partition handle. */
+#ifndef WINAPI
+typedef void *VID_PARTITION_HANDLE;
+#else
+typedef HANDLE VID_PARTITION_HANDLE;
+#endif
+
+/**
+ * Gets the partition ID.
+ *
+ * The partition ID is the numeric identifier used when making hypercalls to the
+ * hypervisor.
+ */
+DECLIMPORT(BOOL) VIDAPI VidGetHvPartitionId(VID_PARTITION_HANDLE hPartition, HV_PARTITION_ID *pidPartition);
+
+/**
+ * Starts asynchronous execution of a virtual CPU.
+ */
+DECLIMPORT(BOOL) VIDAPI VidStartVirtualProcessor(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu);
+
+/**
+ * Stops the asynchronous execution of a virtual CPU.
+ *
+ * @retval ERROR_VID_STOP_PENDING if busy with intercept, check messages.
+ */
+DECLIMPORT(BOOL) VIDAPI VidStopVirtualProcessor(VID_PARTITION_HANDLE hPartition, HV_VP_INDEX iCpu);
+
+/**
+ * WHvCreateVirtualProcessor boils down to a call to VidMessageSlotMap and
+ * some internal WinHvPlatform state fiddling.
+ *
+ * Looks like it maps memory and returns the pointer to it.
+ * VidMessageSlotHandleAndGetNext is later used to wait for the next message and
+ * put (??) it into that memory mapping.
+ *
+ * @returns Success indicator (details in LastStatusValue and LastErrorValue).
+ *
+ * @param   hPartition  The partition handle.
+ * @param   pOutput     Where to return the pointer to the message memory
+ *                      mapping.  The CPU index is also returned here.
+ * @param   iCpu        The CPU to wait-and-get messages for.
+ */
+DECLIMPORT(BOOL) VIDAPI VidMessageSlotMap(VID_PARTITION_HANDLE hPartition, PVID_MAPPED_MESSAGE_SLOT pOutput, HV_VP_INDEX iCpu);
+
+/**
+ * This is used by WHvRunVirtualProcessor to wait for the next exit msg.
+ *
+ * The message appears in the memory mapping returned by VidMessageSlotMap.
+ *
+ * @returns Success indicator (details only in LastErrorValue - LastStatusValue
+ *          is not set).
+ * @retval  STATUS_TIMEOUT for STATUS_TIMEOUT as well as STATUS_USER_APC and
+ *          STATUS_ALERTED.
+ *
+ * @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.
+ *
+ * @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,
+                                                       uint32_t fFlags, uint32_t cMillies);
 /**
  * Gets the processor running status.
@@ -219 +220 @@
 
 RT_C_DECLS_END
+#endif /* IN_RING3 */
 
 #endif