Funzione QueryPerformanceCounter (profileapi.h)

Articolo
03/05/2024

Recupera il valore corrente del contatore delle prestazioni, ovvero un timestamp ad alta risoluzione (<1us) che può essere usato per le misurazioni a intervalli 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, nei 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 informazioni dettagliate sull'errore, chiamare GetLastError. Nei sistemi che eseguono Windows XP o versioni successive, la funzione avrà sempre esito positivo e non restituirà mai zero.

Commenti

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

Esempio

// 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	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	profileapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll