Changeset 22114 in vbox for trunk/include/iprt

Timestamp:

Aug 9, 2009 11:07:56 PM (16 years ago)

Author:

vboxsync

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

50872

Message:

RTDbgMod: Added module tagging so the diggers can tell which modules are theirs when refreshing.

File:

• trunk/include/iprt/dbg.h (modified) (1 diff)

trunk/include/iprt/dbg.h

@@ -666 +666 @@
 RTDECL(RTUINTPTR)   RTDbgModImageSize(RTDBGMOD hDbgMod);
 
+/**
+ * Gets the module tag value if any.
+ *
+ * @returns The tag. 0 if hDbgMod is invalid.
+ *
+ * @param   hDbgMod         The module handle.
+ */
+RTDECL(uint64_t)    RTDbgModGetTag(RTDBGMOD hDbgMod);
+
+/**
+ * Tags or untags the module.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_INVALID_HANDLE if hDbgMod is invalid.
+ *
+ * @param   hDbgMod         The module handle.
+ * @param   uTag            The tag value.  The convention is that 0 is no tag
+ *                          and any other value means it's tagged.  It's adviced
+ *                          to use some kind of unique number like an address
+ *                          (global or string cache for instance) to avoid
+ *                          collisions with other users
+ */
+RTDECL(int)         RTDbgModSetTag(RTDBGMOD hDbgMod, uint64_t uTag);
+
 
 /**