Changeset 32190 in vbox for trunk/include/VBox

Timestamp:

Sep 2, 2010 12:20:06 PM (14 years ago)

Author:

vboxsync

Message:

PDMDevHlpVMSuspendSaveAndPowerOff: More code.

Location:

trunk/include/VBox

Files:

• types.h (modified) (1 diff)
• uvm.h (modified) (2 diffs)
• vmapi.h (modified) (1 diff)
• vmm.h (modified) (1 diff)

trunk/include/VBox/types.h

@@ -719 +719 @@
 
 
+/** Pointer to a callback method table provided by the VM API user. */
+typedef struct VMM2USERMETHODS const *PCVMM2USERMETHODS;
+
+
 /**
  * Data transport buffer (scatter/gather)

trunk/include/VBox/uvm.h

@@ -72 +72 @@
 {
     /** Magic / eye-catcher (UVM_MAGIC). */
-    uint32_t        u32Magic;
+    uint32_t            u32Magic;
     /** The number of virtual CPUs. */
-    uint32_t        cCpus;
+    uint32_t            cCpus;
     /** The ring-3 mapping of the shared VM structure. */
-    PVM             pVM;
+    PVM                 pVM;
     /** Pointer to the next VM.
      * We keep a per process list of VM for the event that a process could
@@ -82 +82 @@
      * @todo move this into vm.s!
      */
-    struct UVM     *pNext;
+    struct UVM         *pNext;
 
+    /** Pointer to the optional method table provided by the VMM user. */
+    PCVMM2USERMETHODS   pVmm2UserMethods;
+
+#if HC_ARCH_BITS == 32
     /** Align the next member on a 32 byte boundrary. */
-    uint8_t         abAlignment0[HC_ARCH_BITS == 32 ? 16 : 8];
+    uint8_t             abAlignment0[HC_ARCH_BITS == 32 ? 12 : 0];
+#endif
 
     /** The VM internal data. */

trunk/include/VBox/vmapi.h

@@ -312 +312 @@
 
 
-VMMR3DECL(int)  VMR3Create(uint32_t cCpus, PFNVMATERROR pfnVMAtError, void *pvUserVM, PFNCFGMCONSTRUCTOR pfnCFGMConstructor, void *pvUserCFGM, PVM *ppVM);
+VMMR3DECL(int)  VMR3Create(uint32_t cCpus, PCVMM2USERMETHODS pVm2UserCbs,
+                           PFNVMATERROR pfnVMAtError, void *pvUserVM,
+                           PFNCFGMCONSTRUCTOR pfnCFGMConstructor, void *pvUserCFGM,
+                           PVM *ppVM);
 VMMR3DECL(int)  VMR3PowerOn(PVM pVM);
 VMMR3DECL(int)  VMR3Suspend(PVM pVM);

trunk/include/VBox/vmm.h

@@ -138 +138 @@
 /** Pointer to a rendezvous callback function. */
 typedef FNVMMEMTRENDEZVOUS *PFNVMMEMTRENDEZVOUS;
+
+/**
+ * Method table that the VMM uses to call back the user of the VMM.
+ */
+typedef struct VMM2USERMETHODS
+{
+    /** Magic value (VMM2USERMETHODS_MAGIC). */
+    uint32_t    u32Magic;
+    /** Structure version (VMM2USERMETHODS_VERSION). */
+    uint32_t    u32Version;
+
+    /**
+     * Save the VM state.
+     *
+     * @returns VBox status code.
+     * @param   pThis       Pointer to the callback method table.
+     * @param   pVM         The VM handle.
+     *
+     * @remarks This member shall be set to NULL if the operation is not
+     *          supported.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnSaveState,(PCVMM2USERMETHODS pThis, PVM pVM));
+    /** @todo Move pfnVMAtError and pfnCFGMConstructor here? */
+
+    /** Magic value (VMM2USERMETHODS_MAGIC) marking the end of the structure. */
+    uint32_t    u32EndMagic;
+} VMM2USERMETHODS;
+
+/** Magic value of the VMM2USERMETHODS (Franz Kafka). */
+#define VMM2USERMETHODS_MAGIC         UINT32_C(0x18830703)
+/** The VMM2USERMETHODS structure version. */
+#define VMM2USERMETHODS_VERSION       UINT32_C(0x00010000)