Changeset 14824 in vbox for trunk/include/iprt/memobj.h

Timestamp:

Nov 30, 2008 7:52:59 AM (16 years ago)

Author:

vboxsync

Message:

IPRT: RTR0MemObjMapKernelEx for mapping a portion of a memory object into ring-0. Only implemented on darwin (where I had to switch back to use I/O kit to wire memory instead of vm_map_wire).

File:

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

trunk/include/iprt/memobj.h

@@ -188 +188 @@
  *          physical memory on this platform. The caller should expect
  *          this error and have a fallback strategy for it.
+ *
  * @param   pMemObj         Where to store the ring-0 memory object handle.
  * @param   cb              Number of bytes to allocate. This is rounded up to nearest page.
@@ -240 +241 @@
  * Maps a memory object into kernel virtual address space.
  *
+ * This is the same as calling RTR0MemObjMapKernelEx with cbSub and offSub set
+ * to zero.
+ *
  * @returns IPRT status code.
  * @param   pMemObj         Where to store the ring-0 memory object handle of the mapping object.
@@ -251 +255 @@
 
 /**
+ * Maps a memory object into kernel virtual address space.
+ *
+ * The ability to map subsections of the object into kernel space is currently
+ * not implemented on all platforms. All/Most of platforms supports mapping the
+ * whole object into  kernel space.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_NOT_SUPPORTED if it's not possible to map a subsection of a
+ *          memory object on this platform. When you hit this, try implement it.
+ *
+ * @param   pMemObj         Where to store the ring-0 memory object handle of the mapping object.
+ * @param   MemObjToMap     The object to be map.
+ * @param   pvFixed         Requested address. (void *)-1 means any address. This must match the alignment.
+ * @param   uAlignment      The alignment of the reserved memory.
+ *                          Supported values are 0 (alias for PAGE_SIZE), PAGE_SIZE, _2M and _4M.
+ * @param   fProt           Combination of RTMEM_PROT_* flags (except RTMEM_PROT_NONE).
+ * @param   offSub          Where in the object to start mapping. If non-zero
+ *                          the value must be page aligned and cbSub must be
+ *                          non-zero as well.
+ * @param   cbSub           The size of the part of the object to be mapped. If
+ *                          zero the entire object is mapped. The value must be
+ *                          page aligned.
+ */
+RTR0DECL(int) RTR0MemObjMapKernelEx(PRTR0MEMOBJ pMemObj, RTR0MEMOBJ MemObjToMap, void *pvFixed, size_t uAlignment,
+                                    unsigned fProt, size_t offSub, size_t cbSub);
+
+/**
  * Maps a memory object into user virtual address space in the current process.
  *