timeGetTime (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the system time, in milliseconds. The system time is the time elapsed since the system started.

Syntax

DWORD timeGetTime(void);

Parameters

None.

Return Value

Returns the system time, in milliseconds.

Remarks

The only difference between this function and the timeGetSystemTime function is that timeGetSystemTime uses the MMTIME structure to return the system time. The timeGetTime function has less overhead than timeGetSystemTime.

The value returned by the timeGetTime function is a DWORD value.

The return value resets to zero every 2^32 milliseconds, which is about 49.71 days. This can cause problems in code that directly uses the timeGetTime return value in computations, particularly when the value is used to control code execution. Depending on how you are using the hardware timer, you may need to handle the timer reset condition.

Always use the difference between two timeGetTime return values in computations.

Requirements

See Also

Reference

Timer Driver Functions
MMTIME
timeGetSystemTime

Other Resources

Time Reference