Changeset 13367 in vbox for trunk/include

Timestamp:

Oct 17, 2008 11:19:29 AM (16 years ago)

Author:

vboxsync

Message:

Added new devhlp functions.

File:

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

trunk/include/VBox/pdmdev.h

@@ -2767 +2767 @@
     DECLR3CALLBACKMEMBER(int, pfnUnregisterVMMDevHeap,(PPDMDEVINS pDevIns, RTGCPHYS GCPhys));
 
+    /**
+     * Register a Memory Mapped I/O (MMIO) region with backing memory.
+     *
+     * These callbacks are of course for the host context (HC).
+     * Register HC handlers before guest context (GC) handlers! There must be a
+     * HC handler for every GC handler!
+     *
+     * @returns VBox status.
+     * @param   pDevIns             The device instance to register the MMIO with.
+     * @param   GCPhysStart         First physical address in the range.
+     * @param   cbRange             The size of the range (in bytes).
+     * @param   pvUser              User argument.
+     * @param   pfnWrite            Pointer to function which is gonna handle Write operations.
+     * @param   pfnRead             Pointer to function which is gonna handle Read operations.
+     * @param   pfnFill             Pointer to function which is gonna handle Fill/memset operations. (optional)
+     * @param   pszDesc             Pointer to description string. This must not be freed.
+     */
+    DECLR3CALLBACKMEMBER(int, pfnMMIORegisterEx,(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTHCPTR pvUser,
+                                                 PFNIOMMMIOWRITE pfnWrite, PFNIOMMMIOREAD pfnRead, PFNIOMMMIOFILL pfnFill,
+                                                 const char *pszDesc));
+
     /** @} */
 
@@ -2898 +2919 @@
     DECLRCCALLBACKMEMBER(int, pfnPATMSetMMIOPatchInfo,(PPDMDEVINS pDevIns, RTGCPHYS GCPhys, RTGCPTR pCachedData));
 
+    /**
+     * Gets the VM handle. Restricted API.
+     *
+     * @returns VM Handle.
+     * @param   pDevIns         Device instance.
+     */
+    DECLRCCALLBACKMEMBER(PVM, pfnGetVM,(PPDMDEVINS pDevIns));
+
     /** Just a safety precaution. */
     uint32_t                        u32TheEnd;
@@ -3025 +3054 @@
      */
     DECLR0CALLBACKMEMBER(int, pfnPATMSetMMIOPatchInfo,(PPDMDEVINS pDevIns, RTGCPHYS GCPhys, RTGCPTR pCachedData));
+
+    /**
+     * Gets the VM handle. Restricted API.
+     *
+     * @returns VM Handle.
+     * @param   pDevIns         Device instance.
+     */
+    DECLR0CALLBACKMEMBER(PVM, pfnGetVM,(PPDMDEVINS pDevIns));
 
     /** Just a safety precaution. */
@@ -3228 +3265 @@
 
 /**
+ * @copydoc PDMDEVHLPR3::pfnMMIORegisterEx
+ */
+DECLINLINE(int) PDMDevHlpMMIORegisterEx(PPDMDEVINS pDevIns, RTGCPHYS GCPhysStart, RTUINT cbRange, RTHCPTR pvUser,
+                                        PFNIOMMMIOWRITE pfnWrite, PFNIOMMMIOREAD pfnRead, PFNIOMMMIOFILL pfnFill,
+                                        const char *pszDesc)
+{
+    return pDevIns->pDevHlpR3->pfnMMIORegisterEx(pDevIns, GCPhysStart, cbRange, pvUser, pfnWrite, pfnRead, pfnFill, pszDesc);
+}
+
+/**
  * @copydoc PDMDEVHLPR3::pfnMMIORegisterGC
  */
@@ -3448 +3495 @@
 
 /**
- * @copydoc PDMDEVHLPR3::pfnGetVM
- */
-DECLINLINE(PVM) PDMDevHlpGetVM(PPDMDEVINS pDevIns)
-{
-    return pDevIns->pDevHlpR3->pfnGetVM(pDevIns);
-}
-
-/**
  * @copydoc PDMDEVHLPR3::pfnPhysReadGCVirt
  */
@@ -3609 +3648 @@
 #endif /* IN_RING3 */
 
+
+/**
+ * @copydoc PDMDEVHLPR3::pfnGetVM
+ */
+DECLINLINE(PVM) PDMDevHlpGetVM(PPDMDEVINS pDevIns)
+{
+    return pDevIns->CTX_SUFF(pDevHlp)->pfnGetVM(pDevIns);
+}
 
 /**