Funzione QueryPerformanceFrequency (profileapi.h)

Recupera la frequenza del contatore delle prestazioni. La frequenza del contatore delle prestazioni è fissa all'avvio del sistema ed è coerente in tutti i processori. Di conseguenza, la frequenza deve essere eseguita solo all'inizializzazione dell'applicazione e il risultato può essere memorizzato nella cache.

Sintassi

BOOL QueryPerformanceFrequency(
  [out] LARGE_INTEGER *lpFrequency
);

Parametri

[out] lpFrequency

Puntatore a una variabile che riceve la frequenza corrente del contatore delle prestazioni, in conteggi al secondo. Se l'hardware installato non supporta un contatore delle prestazioni ad alta risoluzione, questo parametro può essere zero (questo non si verificherà nei sistemi che eseguono Windows XP o versione successiva).

Valore restituito

Se l'hardware installato supporta un contatore delle prestazioni ad alta risoluzione, 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.

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

QueryPerformanceCounter

Riferimento

Tempo

Timer