Função QueryPerformanceCounter (profileapi.h)

Artigo
03/08/2023

Recupera o valor atual do contador de desempenho, que é um carimbo de data/hora de alta resolução (<1us) que pode ser usado para medidas de intervalo de tempo.

Sintaxe

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Parâmetros

[out] lpPerformanceCount

Um ponteiro para uma variável que recebe o valor atual do contador de desempenho, em contagens.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError. Em sistemas que executam o Windows XP ou posterior, a função sempre terá êxito e, portanto, nunca retornará zero.

Comentários

Para obter mais informações sobre essa função e seu uso, consulte Adquirir carimbos de data/hora de alta resolução.

Exemplos

// Gets the current number of ticks from QueryPerformanceCounter. Throws an
// exception if the call to QueryPerformanceCounter fails.
static inline int64_t GetTicks()
{
    LARGE_INTEGER ticks;
    if (!QueryPerformanceCounter(&ticks))
    {
        winrt::throw_last_error();
    }
    return ticks.QuadPart;
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	profileapi.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll