Changeset 104848 in vbox for trunk/include

Timestamp:

Jun 5, 2024 9:38:20 AM (8 months ago)

Author:

vboxsync

Message:

VMM/PGM,SUPDrv,IPRT: Added a RTR0MemObjZeroInitialize function to IPRT/SUPDrv for helping zero initializing MMIO2 backing memory. bugref:10687

Location:

trunk/include/iprt

Files:

trunk/include/iprt/mangling.h

r104745	r104848
1917	1917	# define RTR0MemObjSize RT_MANGLER(RTR0MemObjSize) /* r0drv */
1918	1918	# define RTR0MemObjWasZeroInitialized RT_MANGLER(RTR0MemObjWasZeroInitialized)/* r0drv */
	1919	# define RTR0MemObjZeroInitialize RT_MANGLER(RTR0MemObjZeroInitialize) /* r0drv */
1919	1920	# define RTR0MemUserCopyFrom RT_MANGLER(RTR0MemUserCopyFrom) /* r0drv */
1920	1921	# define RTR0MemUserCopyTo RT_MANGLER(RTR0MemUserCopyTo) /* r0drv */

-              r100358
+              r104848
  * @returns true if the allocation was initialized to zero at allocation time,
  *          false if not or query not meaningful to the object type.
  * @param   hMemObj             The ring-0 memory object to be freed.
+ * @param   hMemObj             The ring-0 memory object.
+ *
  * @remarks It can be expected that memory allocated in the same fashion will
 …
  */
 RTR0DECL(bool) RTR0MemObjWasZeroInitialized(RTR0MEMOBJ hMemObj);
+/**
+ * Initializes the allocation to zero.
+ *
+ * This only works on allocations, locked ring-0 memory and ring-0 mappings.  It
+ * will return VERR_WRONG_TYPE if applied to any memory reservation,
+ * ring-3 mapping or ring-3 locking object.
+ *
+ * @returns IPRT status code.
+ * @param   hMemObj         The ring-0 memory object.
+ * @param   fForce          If @c true, always zero the allocation, if @c false
+ *                          it is only done when RTR0MemObjWasZeroInitialized()
+ *                          would return false.
+ */
+RTR0DECL(int) RTR0MemObjZeroInitialize(RTR0MEMOBJ hMemObj, bool fForce);
 /**

Note: See TracChangeset for help on using the changeset viewer.