Funzione QueryPerformanceCounter (profileapi.h)

Recupera il valore corrente del contatore delle prestazioni, ovvero un timestamp ad alta risoluzione (<1us) che può essere utilizzato per le misurazioni dell'intervallo di tempo.

Sintassi

BOOL QueryPerformanceCounter(
  [out] LARGE_INTEGER *lpPerformanceCount
);

Parametri

[out] lpPerformanceCount

Puntatore a una variabile che riceve il valore corrente del contatore delle prestazioni, in conteggi.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError. Nei sistemi che eseguono Windows XP o versioni successive, la funzione avrà sempre esito positivo quando vengono specificati parametri validi e quindi non restituirà mai zero.

Osservazioni:

Per altre info su questa funzione e sul relativo utilizzo, vedi Acquisizione di timestamp ad alta risoluzione.

Esempi

// 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;
}

Requisiti

Requisito	Value
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Header	profileapi.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Acquisizione di timestamp ad alta risoluzione

Concettuale

GetSystemTimePreciseAsFileTime

KeQueryPerformanceCounter

QueryPerformanceFrequency

Riferimento

Tempo

Timer