Função timeGetTime (timeapi.h)

A função timeGetTime recupera o tempo do sistema, em milissegundos. A hora do sistema é o tempo decorrido desde que o Windows foi iniciado.

Sintaxe

DWORD timeGetTime();

Retornar valor

Retorna a hora do sistema, em milissegundos.

Comentários

A única diferença entre essa função e a função timeGetSystemTime é que timeGetSystemTime usa a estrutura MMTIME para retornar a hora do sistema. A função timeGetTime tem menos sobrecarga do que timeGetSystemTime.

Observe que o valor retornado pela função timeGetTime é um valor DWORD . O valor retornado é encapsulado em torno de 0 a cada 2^32 milissegundos, que é de cerca de 49,71 dias. Isso pode causar problemas no código que usa diretamente o valor de retorno timeGetTime em computações, especialmente quando o valor é usado para controlar a execução do código. Você sempre deve usar a diferença entre dois valores de retorno timeGetTime em cálculos.

A precisão padrão da função timeGetTime pode ser de cinco milissegundos ou mais, dependendo do computador. Você pode usar as funções timeBeginPeriod e timeEndPeriod para aumentar a precisão de timeGetTime. Se você fizer isso, a diferença mínima entre valores sucessivos retornados por timeGetTime poderá ser tão grande quanto o valor de período mínimo definido usando timeBeginPeriod e timeEndPeriod. Use as funções QueryPerformanceCounter e QueryPerformanceFrequency para medir intervalos de tempo curtos em alta resolução.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	timeapi.h (inclua Windows.h)
Biblioteca	Winmm.lib
DLL	Winmm.dll

Confira também

Funções de temporizador multimídia

Temporizadores multimídia