Changeset 47352 in vbox for trunk/include/iprt

Timestamp:

Jul 23, 2013 4:19:20 PM (11 years ago)

Author:

vboxsync

Message:

Runtime/r0drv: Reference counting for kernel thread-context hooks.

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• thread.h (modified) (3 diffs)

trunk/include/iprt/mangling.h

@@ -1594 +1594 @@
 # define RTThreadCtxHooksCreate                         RT_MANGLER(RTThreadCtxHooksCreate)         /* r0drv */
 # define RTThreadCtxHooksDeregister                     RT_MANGLER(RTThreadCtxHooksDeregister)     /* r0drv */
-# define RTThreadCtxHooksDestroy                        RT_MANGLER(RTThreadCtxHooksDestroy)        /* r0drv */
 # define RTThreadCtxHooksRegister                       RT_MANGLER(RTThreadCtxHooksRegister)       /* r0drv */
+# define RTThreadCtxHooksRelease                        RT_MANGLER(RTThreadCtxHooksRelease)        /* r0drv */
+# define RTThreadCtxHooksRetain                         RT_MANGLER(RTThreadCtxHooksRetain)         /* r0drv */
 # define RTThreadFromNative                             RT_MANGLER(RTThreadFromNative)
 # define RTThreadGetAffinity                            RT_MANGLER(RTThreadGetAffinity)

trunk/include/iprt/thread.h

@@ -610 +610 @@
 
 /**
- * Create a handle for a thread-context hook.
+ * Initializes a thread-context hook for the current thread.
  *
  * This must be called once per-thread before using RTThreadCtxHooksRegister().
@@ -617 +617 @@
  * @param   phThreadCtx         Where to store the thread-context handle.
  *
- * @remarks Must be called with preemption enabled!
+ * @remarks This must be called with preemption enabled!
  */
 RTDECL(int) RTThreadCtxHooksCreate(PRTTHREADCTX phThreadCtx);
 
 /**
- * Destroy a thread-context hook handle for the current thread.
- *
- * This will deregister any thread-context hooks registered under this handle if
- * required.
- *
+ * Retains a new reference to a thread-context hook.
+ *
+ * @returns New reference count.
+ *          UINT32_MAX is returned if the handle is invalid (asserted).
  * @param   phThreadCtx         Pointer to the thread-context handle.
  *
- * @remarks Must be called with preemption enabled!
- */
-RTDECL(void) RTThreadCtxHooksDestroy(RTTHREADCTX hThreadCtx);
+ * @remarks This can be called from any thread. Can be called with preemption
+ *          disabled.
+ */
+RTDECL(uint32_t) RTThreadCtxHooksRetain(RTTHREADCTX hThreadCtx);
+
+/**
+ * Releases a reference to a thread-context hook.
+ *
+ * @returns New reference count, if 0 the thread-context hook was freed.
+ *          UINT32_MAX is returned if the handle is invalid (asserted).
+ * @param   phThreadCtx         Pointer to the thread-context handle.
+ *
+ * @remarks This can be called from any thread but must be called with
+ *          preemption enabled!
+ */
+RTDECL(uint32_t) RTThreadCtxHooksRelease(RTTHREADCTX hThreadCtx);
 
 /**
@@ -648 +660 @@
 
 /**
- * Deregisters a thread-context hook for the current thread.
+ * Deregisters the thread-context hook for the current thread.
  *
  * @returns IPRT status code.