GetHSecTime

Obtains the current time in hundredths of a second.

Synopsis

int32 GetHSecTime (Item ioreq)

Description

Obtains the current value of the system microsecond timer, converts the seconds and microseconds into a single hundredths-of-a-second value, and returns the converted value.

The return value will overflow an int32 representation after the machine has been powered on for about 250 days. In other words, this function is probably appropriate for debugging and performance measurement, but may NOT be appropriate for a final application, since some application environments (such as cable TV) are almost certain to run on a machine powered on for months at a time.

Arguments

ioreq: An IOReq item obtained from GetTimerIOReq(), or zero to have an IOReq dynamically created/deleted during the call.

Return Value

Returns positive number of hundredths-of-a-second or a negative error code.

Implementation

Library call implemented in lib3do.lib.

Associated Files

lib3do.lib, timerutils.h