Função QueryPerformanceCounter (profileapi.h)

Recupera o valor atual do contador de desempenho, que é um carimbo de 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 de retorno

Se a função for bem-sucedida, o valor retornado não será 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 quando determinados parâmetros válidos e, portanto, nunca retornará zero.

Observações

Para obter mais informações sobre essa função e seu uso, consulte Como 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;
}

Requirements

Consulte também

Adquirindo carimbos de data/hora de alta resolução

Conceitual

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Referência

Hora

Temporizadores