Changeset 6162 in vbox for trunk/include

Timestamp:

Dec 20, 2007 11:27:44 PM (17 years ago)

Author:

vboxsync

Message:

Wrappers for template creation the right way.

Location:

trunk/include/VBox

Files:

• pdmasynccompletion.h (modified) (3 diffs)
• pdmdrv.h (modified) (2 diffs)

trunk/include/VBox/pdmasynccompletion.h

@@ -124 +124 @@
  * @param   pszDesc         Description.
  */
-PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDevice(PVM pVM, PPDMDEVINS pDevIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDEV pfnCompleted, const char *pszDesc);
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDeviceEx(PVM pVM, PPDMDEVINS pDevIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDEV pfnCompleted, const char *pszDesc);
+
+/**
+ * Creates a async completion template for a device instance.
+ * Wrapper for PDMR3AsyncCompletionTemplateCreateDeviceEx.
+ *
+ * The template is used when creating new completion tasks.
+ *
+ * @returns VBox status code.
+ * @param   pDevIns         The device instance.
+ * @param   ppTemplate      Where to store the template pointer on success.
+ * @param   pfnCompleted    The completion callback routine.
+ * @param   pszDesc         Description.
+ */
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDevice(PPDMDEVINS pDevIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDEV pfnCompleted, const char *pszDesc);
 
 /**
@@ -138 +152 @@
  * @param   pszDesc         Description.
  */
-PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDriver(PVM pVM, PPDMDRVINS pDrvIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDRV pfnCompleted, const char *pszDesc);
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDriverEx(PVM pVM, PPDMDRVINS pDrvIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDRV pfnCompleted, const char *pszDesc);
+
+/**
+ * Creates a async completion template for a driver instance.
+ * Wrapper for PDMR3AsyncCompletionTemplateCreateDriverEx.
+ *
+ * The template is used when creating new completion tasks.
+ *
+ * @returns VBox status code.
+ * @param   pDrvIns         The driver instance.
+ * @param   ppTemplate      Where to store the template pointer on success.
+ * @param   pfnCompleted    The completion callback routine.
+ * @param   pszDesc         Description.
+ */
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateDriver(PPDMDRVINS pDrvIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEDRV pfnCompleted, const char *pszDesc);
 
 /**
@@ -152 +180 @@
  * @param   pszDesc         Description.
  */
-PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateUsb(PVM pVM, PPDMUSBINS pUsbIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEUSB pfnCompleted, const char *pszDesc);
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateUsbEx(PVM pVM, PPDMUSBINS pUsbIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEUSB pfnCompleted, const char *pszDesc);
+
+/**
+ * Creates a async completion template for a USB device instance.
+ * Wrapper for PDMR3AsyncCompletionTemplateCreateUsbEx.
+ *
+ * The template is used when creating new completion tasks.
+ *
+ * @returns VBox status code.
+ * @param   pUsbIns         The USB device instance.
+ * @param   ppTemplate      Where to store the template pointer on success.
+ * @param   pfnCompleted    The completion callback routine.
+ * @param   pszDesc         Description.
+ */
+PDMR3DECL(int) PDMR3AsyncCompletionTemplateCreateUsb(PPDMUSBINS pUsbIns, PPPDMASYNCCOMPLETIONTEMPLATE ppTemplate, PFNPDMASYNCCOMPLETEUSB pfnCompleted, const char *pszDesc);
 
 /**

trunk/include/VBox/pdmdrv.h

@@ -652 +652 @@
                                                   PFNPDMTHREADWAKEUPDRV pfnWakeup, size_t cbStack, RTTHREADTYPE enmType, const char *pszName));
 
-    /**
-     * Gets the VM handle.
-     *
-     * @returns VM Handle.
-     * @param   pDrvIns         Driver instance.
-     */
-    DECLR3CALLBACKMEMBER(PVM, pfnGetVM,(PPDMDRVINS pDrvIns));
-
     /** Just a safety precaution. */
     uint32_t                        u32TheEnd;
@@ -817 +809 @@
 }
 
-/**
- * @copydoc PDMDRVHLP::pfnGetVM
- */
-DECLINLINE(PVM) PDMDrvHlpGetVM(PPDMDRVINS pDrvIns)
-{
-    return pDrvIns->pDrvHlp->pfnGetVM(pDrvIns);
-}
 #endif /* IN_RING3 */