Changeset 46567 in vbox for trunk/include/iprt

Timestamp:

Jun 14, 2013 4:12:24 PM (12 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

86432

Message:

RTMemAllocEx for ring-3.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (2 diffs)
• mem.h (modified) (3 diffs)

trunk/include/iprt/mangling.h

@@ -812 +812 @@
 # define RTMd5ToString                                  RT_MANGLER(RTMd5ToString)
 # define RTMd5Update                                    RT_MANGLER(RTMd5Update)
-# define RTMemAllocExTag                                RT_MANGLER(RTMemAllocExTag) /* r0drv */
+# define RTMemAllocExTag                                RT_MANGLER(RTMemAllocExTag)
 # define RTMemAllocTag                                  RT_MANGLER(RTMemAllocTag)
 # define RTMemAllocVarTag                               RT_MANGLER(RTMemAllocVarTag)
@@ -852 +852 @@
 # define RTMemExecFree                                  RT_MANGLER(RTMemExecFree)
 # define RTMemFree                                      RT_MANGLER(RTMemFree)
-# define RTMemFreeEx                                    RT_MANGLER(RTMemFreeEx)     /* r0drv */
+# define RTMemFreeEx                                    RT_MANGLER(RTMemFreeEx)
 # define RTMemPageAllocTag                              RT_MANGLER(RTMemPageAllocTag)
 # define RTMemPageAllocZTag                             RT_MANGLER(RTMemPageAllocZTag)

trunk/include/iprt/mem.h

@@ -314 +314 @@
  * Will return VERR_NOT_SUPPORTED if not supported. */
 #define RTMEMALLOCEX_FLAGS_ANY_CTX          (RTMEMALLOCEX_FLAGS_ANY_CTX_ALLOC | RTMEMALLOCEX_FLAGS_ANY_CTX_FREE)
+/** Reachable by 16-bit address.
+ * Will return VERR_NOT_SUPPORTED if not supported.  */
+#define RTMEMALLOCEX_FLAGS_16BIT_REACH      RT_BIT(4)
+/** Reachable by 32-bit address.
+ * Will return VERR_NOT_SUPPORTED if not supported.  */
+#define RTMEMALLOCEX_FLAGS_32BIT_REACH      RT_BIT(5)
 /** Mask of valid flags. */
-#define RTMEMALLOCEX_FLAGS_VALID_MASK       UINT32_C(0x0000000f)
+#define RTMEMALLOCEX_FLAGS_VALID_MASK       UINT32_C(0x0000003f)
+/** Mask of valid flags for ring-0. */
+#define RTMEMALLOCEX_FLAGS_VALID_MASK_R0    UINT32_C(0x0000000f)
 /** @}  */
 
@@ -337 +345 @@
 /**
  * Extended heap allocation API, custom tag.
+ *
+ * Depending on the implementation, using this function may add extra overhead,
+ * so use the simpler APIs where ever possible.
  *
  * @returns IPRT status code.
@@ -358 +369 @@
  * @param   pv                  What to free, NULL is fine.
  * @param   cb                  The amount of allocated memory.
+ * @param   fFlags              The flags specified when allocating the memory.
+ *                              Whether the exact flags are requires depends on
+ *                              the implementation, but in general, ring-0
+ *                              doesn't require anything while ring-3 requires
+ *                              RTMEMALLOCEX_FLAGS_EXEC if used.
  */
 RTDECL(void) RTMemFreeEx(void *pv, size_t cb) RT_NO_THROW;