Changeset 39910 in vbox for trunk/include/iprt

Timestamp:

Jan 30, 2012 4:05:58 PM (13 years ago)

Author:

vboxsync

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

75982

Message:

Runtime/Timers: RTTimerLRChangeInterval function and testcase

Location:

trunk/include/iprt

Files:

• mangling.h (modified) (1 diff)
• timer.h (modified) (1 diff)

trunk/include/iprt/mangling.h

@@ -1543 +1543 @@
 # define RTTimerLRStart                                 RT_MANGLER(RTTimerLRStart)
 # define RTTimerLRStop                                  RT_MANGLER(RTTimerLRStop)
+# define RTTimerLRChangeInterval                        RT_MANGLER(RTTimerLRChangeInterval)
 # define RTTimerReleaseSystemGranularity                RT_MANGLER(RTTimerReleaseSystemGranularity) /* r0drv */
 # define RTTimerRequestSystemGranularity                RT_MANGLER(RTTimerRequestSystemGranularity) /* r0drv */

trunk/include/iprt/timer.h

@@ -355 +355 @@
 RTDECL(int) RTTimerLRStop(RTTIMERLR hTimerLR);
 
+/**
+ * Changes the interval of a low resolution timer.
+ *
+ * If the timer is active, the next tick will occure immediately just like with
+ * RTTimerLRStart() when u64First parameter is zero.
+ *
+ * @returns IPRT status code.
+ * @retval  VERR_INVALID_HANDLE if pTimer isn't valid.
+ * @retval  VERR_NOT_SUPPORTED if not supported.
+ *
+ * @param   hTimerLR            The low resolution timer to update.
+ * @param   u64NanoInterval     The interval between timer ticks specified in
+ *                              nanoseconds.  This is rounded to the fit the
+ *                              system timer granularity.
+ * @remarks Callable from the timer callback.
+ */
+RTDECL(int) RTTimerLRChangeInterval(RTTIMERLR hTimerLR, uint64_t u64NanoInterval);
+
 /** @} */