Skip to main content

StopMSTimer

StopMSTimer (timerRefNum)​

The StopMSTimer function frees up the timer associated with the timerRefNum and returns the number of elapsed microseconds since StartMSTimer was called for this timer.

Parameters​

timerRefNum is the value returned by StartMSTimer or the special values -1 or -2. If timerRefNum is not valid then StopMSTimer returns 0.

On Windows, passing -1 returns the clock frequency of the timer.

Passing -2 returns the time in microseconds since the computer was started.

Details​

If you want to make sure that all timers are free, call StopMSTimer ten times with timerRefNum equal to 0 through 9. It is OK to stop a timer that you never started.

Examples​

How long does an empty loop take on your computer?

Function TestMSTimer()
	Variable timerRefNum
	Variable microSeconds
	Variable n
	timerRefNum = StartMSTimer
	if (timerRefNum == -1)
		Abort "All timers are in use"
	endif
	n=10000
	do
		n -= 1
	while (n > 0)
	microSeconds = StopMSTimer(timerRefNum)
	Print microSeconds/10000, "microseconds per iteration"
End

See Also​

StartMSTimer, ticks, DateTime