Changeset 44393 in vbox for trunk/include/VBox/vmm

Timestamp:

Jan 25, 2013 9:21:05 PM (12 years ago)

Author:

vboxsync

Message:

VM,++: Changed the VM callbacks (at error, at runtime error, at state change) to use PUVM instead of PVM.

File:

• trunk/include/VBox/vmm/vmapi.h (modified) (6 diffs)

trunk/include/VBox/vmm/vmapi.h

@@ -93 +93 @@
  * VM error callback function.
  *
- * @param   pVM             The VM handle. Can be NULL if an error occurred before
- *                          successfully creating a VM.
+ * @param   pUVM            The user mode VM handle.  Can be NULL if an error
+ *                          occurred before successfully creating a VM.
  * @param   pvUser          The user argument.
  * @param   rc              VBox status code.
@@ -101 +101 @@
  * @param   args            Error message arguments.
  */
-typedef DECLCALLBACK(void) FNVMATERROR(PVM pVM, void *pvUser, int rc, RT_SRC_POS_DECL, const char *pszError, va_list args);
+typedef DECLCALLBACK(void) FNVMATERROR(PUVM pUVM, void *pvUser, int rc, RT_SRC_POS_DECL, const char *pszError, va_list args);
 /** Pointer to a VM error callback. */
 typedef FNVMATERROR *PFNVMATERROR;
@@ -129 +129 @@
  * See VMSetRuntimeError for the detailed description of parameters.
  *
- * @param   pVM             The VM handle.
+ * @param   pUVM            The user mode VM handle.
  * @param   pvUser          The user argument.
  * @param   fFlags          The error flags.
@@ -136 +136 @@
  * @param   va              Error message arguments.
  */
-typedef DECLCALLBACK(void) FNVMATRUNTIMEERROR(PVM pVM, void *pvUser, uint32_t fFlags, const char *pszErrorId,
+typedef DECLCALLBACK(void) FNVMATRUNTIMEERROR(PUVM pUVM, void *pvUser, uint32_t fFlags, const char *pszErrorId,
                                               const char *pszFormat, va_list va);
 /** Pointer to a VM runtime error callback. */
@@ -164 +164 @@
 
 /**
- * VM state callback function.
+ * VM state change callback function.
  *
  * You are not allowed to call any function which changes the VM state from a
  * state callback, except VMR3Destroy().
  *
- * @param   pVM         The VM handle.
+ * @param   pUVM        The user mode VM handle.
  * @param   enmState    The new state.
  * @param   enmOldState The old state.
  * @param   pvUser      The user argument.
  */
-typedef DECLCALLBACK(void) FNVMATSTATE(PVM pVM, VMSTATE enmState, VMSTATE enmOldState, void *pvUser);
+typedef DECLCALLBACK(void) FNVMATSTATE(PUVM pUVM, VMSTATE enmState, VMSTATE enmOldState, void *pvUser);
 /** Pointer to a VM state callback. */
 typedef FNVMATSTATE *PFNVMATSTATE;
@@ -318 +318 @@
 /**
  * Progress callback.
+ *
  * This will report the completion percentage of an operation.
  *
  * @returns VINF_SUCCESS.
  * @returns Error code to cancel the operation with.
- * @param   pVM         The VM handle.
+ * @param   pUVM        The user mode VM handle.
  * @param   uPercent    Completion percentage (0-100).
  * @param   pvUser      User specified argument.
  */
-typedef DECLCALLBACK(int) FNVMPROGRESS(PVM pVM, unsigned uPercent, void *pvUser);
+typedef DECLCALLBACK(int) FNVMPROGRESS(PUVM pUVM, unsigned uPercent, void *pvUser);
 /** Pointer to a FNVMPROGRESS function. */
 typedef FNVMPROGRESS *PFNVMPROGRESS;
-
-/**
- * VM destruction callback.
- * @param   pVM     The VM which is about to be destroyed.
- * @param   pvUser  The user parameter specified at registration.
- */
-typedef DECLCALLBACK(void) FNVMATDTOR(PVM pVM, void *pvUser);
-/** Pointer to a VM destruction callback. */
-typedef FNVMATDTOR *PFNVMATDTOR;