Funzione QueryPerformanceFrequency (profileapi.h)

Articolo
03/01/2024

Recupera la frequenza del contatore delle prestazioni. La frequenza del contatore delle prestazioni è fissa all'avvio del sistema ed è coerente in tutti i processori. Pertanto, 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 versioni successive).

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 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 info su questa funzione e sul relativo utilizzo, vedi Acquisizione di timestamp ad alta risoluzione.

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