Share via


Funzione timeGetTime (timeapi.h)

La funzione timeGetTime recupera il tempo di sistema, espresso in millisecondi. Il tempo di sistema è il tempo trascorso dall'avvio di Windows.

Sintassi

DWORD timeGetTime();

Valore restituito

Restituisce l'ora di sistema, espressa in millisecondi.

Commenti

L'unica differenza tra questa funzione e la funzione timeGetSystemTime è che timeGetSystemTime usa la struttura MMTIME per restituire l'ora di sistema. La funzione timeGetTime ha meno overhead rispetto a timeGetSystemTime.

Si noti che il valore restituito dalla funzione timeGetTime è un valore DWORD . Il valore restituito viene disposto intorno a 0 ogni 2^32 millisecondi, ovvero circa 49,71 giorni. Ciò può causare problemi nel codice che usa direttamente il valore restituito timeGetTime nei calcoli, in particolare quando il valore viene usato per controllare l'esecuzione del codice. È consigliabile usare sempre la differenza tra due valori timeGetTime restituiti nei calcoli.

La precisione predefinita della funzione timeGetTime può essere di cinque millisecondi o più, a seconda del computer. È possibile usare le funzioni timeBeginPeriod e timeEndPeriod per aumentare la precisione di timeGetTime. In tal caso, la differenza minima tra i valori successivi restituiti da timeGetTime può essere pari al valore minimo impostato usando timeBeginPeriod e timeEndPeriod. Usare le funzioni QueryPerformanceCounter e QueryPerformanceFrequency per misurare intervalli di tempo brevi a una risoluzione elevata.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione timeapi.h (include Windows.h)
Libreria Winmm.lib
DLL Winmm.dll

Vedi anche

Funzioni timer multimediali

Timer multimediali