Funzione KeQueryPerformanceCounter (ntifs.h)
La routine KeQueryPerformanceCounter recupera il valore corrente e la frequenza del contatore delle prestazioni.
Usare KeQueryPerformanceCounter per acquisire indicatori di tempo ad alta risoluzione (<1μs) per le misurazioni dell'intervallo di tempo.
Sintassi
NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
[out, optional] PLARGE_INTEGER PerformanceFrequency
);
Parametri
[out, optional] PerformanceFrequency
Puntatore a una variabile a cui KeQueryPerformanceCounter scrive la frequenza del contatore delle prestazioni, in tick al secondo. Questo parametro è facoltativo e può essere NULL se il chiamante non necessita del valore della frequenza del contatore.
Valore restituito
KeQueryPerformanceCounter restituisce il valore del contatore delle prestazioni in unità di graduazione.
Osservazioni
KeQueryPerformanceCounter restituisce un intero a 64 bit che rappresenta il valore corrente di un contatore senza creazione monotonica a risoluzione elevata.
Per ottenere la frequenza del contatore delle prestazioni, specificare un valore del puntatore nullnon per il parametro PerformanceFrequency. La frequenza del contatore delle prestazioni è fissa all'avvio del sistema ed è coerente in tutti i processori. Pertanto, un driver può memorizzare nella cache la frequenza del contatore delle prestazioni durante l'inizializzazione.
Per altre info su questa funzione e sul relativo utilizzo, vedi Acquisizione di timestamp ad alta risoluzione.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 2000 |
| piattaforma di destinazione | Universale |
| intestazione | ntifs.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| libreria | Hal.lib |
| dll | Hal.dll |
| IRQL | Qualsiasi livello |