KS_getAbsTime
The function KS_getAbsTime reads the absolute time (obsolete).
ATTENTION! THIS FUNCTION IS OBSOLETE!
C/C++
Error KS_getAbsTime(UInt64* pAbsTime);
Delphi
function KS_getAbsTime(pAbsTime: PUInt64): Error;
C#
int KS_getAbsTime(long* pAbsTime);
Parameters
pAbsTime (UInt64*)
Pointer where to store the time.
Return values
KSERROR_BAD_PARAM | One parameter is wrong. |
KSERROR_FUNCTION_NOT_AVAILABLE | The chosen clock is not available. |
Comments
The function reads the absolute time since 1601-01-01 00:00:00 in tenth of a microsecond.
This function is obsolete! You should use the function KS_getClock with the clock id KS_CLOCK_ABSOLUTE_TIME in new projects.
The function can be used on kernel-level, including real-time mode.
Example 1
KS_getAbsTime returns the same as KS_getMachineTime, except that the value is related to 1601-01-01 in GMT/UTC.
UInt64 absTime;
ksError = KS_getAbsTime(&absTime);
if (ksError != KS_OK)
outputErr(ksError, "KS_getAbsTime", "Unable to get absolute time.");
Example 2
See smp\ClockFunctionsLegacy.
See also
KS_calibrateMachineTime, KS_getSystemTicks, KS_getSystemTime, KS_getMachineTime, KS_getClock, KS_getClockSource, KS_setClockSource, KS_microDelay, KS_convertClock
Contained in: Clock Module
As part of Kithara »RealTime Suite«
Available since: version 2.00
Build date: 2013-04-17
