Supported Browsers Home   
ULZTimerOff Previous   
ULZTimerResolution Next   
External Functions Up   

ULZTimerOn

Starts the Ultra Long Period Zen Timer counting.

Declaration

void ZAPI ULZTimerOn(void)

Prototype In

ztimer.h

Description

Starts the Ultra Long Period Zen Timer counting. Once you have started the timer, you can stop it with ULZTimerOff or you can latch the current count with ULZTimerLap.

The Ultra Long Period Zen Timer uses the available operating system services to obtain accurate timings results with as much precision as the operating system provides, but with enough granularity to time longer periods of time than the Long Period Zen Timer. Note that the resolution of the timer ticks is not constant between different platforms, and you should use the ULZTimerResolution function to determine the number of seconds in a single tick of the timer, and use this to convert the timer counts to seconds.

Under 32-bit Windows, we use the timeGetTime function which provides a resolution of 1 millisecond (0.001 of a second). Given that the timer count is returned as an unsigned 32-bit integer, this we can time intervals that are a maximum of 2^32 milliseconds in length (or about 1,200 hours or 50 days!).

Under 32-bit DOS, we use the system timer tick which runs at 18.2 times per second. Given that the timer count is returned as an unsigned 32-bit integer, this we can time intervals that are a maximum of 2^32 * (1/18.2) in length (or about 65,550 hours or 2731 days!).

See Also

ULZTimerOff, ULZTimerLap, ULZTimerCount, ULZElapsedTime, ULZReadTime

Copyright © 2002 SciTech Software, Inc. Visit our web site at http://www.scitechsoft.com