timeGetTime
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
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
| Header | mmsystem.h |
| Library | Mmtimer.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |