Funzione QueryInterruptTime (realtimeapiset.h)

Articolo
08/25/2023

Ottiene il conteggio del tempo di interruzione corrente. Per un conteggio più preciso, usare QueryInterruptTimePrecise.

Sintassi

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Parametri

[out] lpInterruptTime

Puntatore a ULONGLONG in cui ricevere il conteggio dei tempi di interruzione nelle unità di tempo di sistema di 100 nanosecondi. Dividere per dieci milioni, o 1e7, per ottenere secondi (ci sono 1e9 nanosecondi in un secondo, quindi ci sono 1e7 100 nanosecondi in un secondo).

Valore restituito

nessuno

Osservazioni

Il conteggio dell'ora di interruzione inizia a zero all'avvio del sistema e viene incrementato a ogni interruzione di clock per la lunghezza di un segno di graduazione di clock. La lunghezza esatta di un tick di clock dipende dall'hardware sottostante e può variare tra i sistemi.

Diversamente dall'ora di sistema, il conteggio dei tempi di interruzione non è soggetto a modifiche da parte degli utenti o del servizio ora di Windows. Le applicazioni possono usare il conteggio dei tempi di interruzione per misurare durate più sottili rispetto a quelle possibili con l'ora di sistema. Le applicazioni che richiedono maggiore precisione rispetto al conteggio dei tempi di interruzione devono usare un timer ad alta risoluzione. Usare la funzione QueryPerformanceFrequency per recuperare la frequenza del timer ad alta risoluzione e della funzione QueryPerformanceCounter per recuperare il valore del contatore.

La risoluzione del timer impostata dalle funzioni timeBeginPeriod e timeEndPeriod influisce sulla risoluzione della funzione QueryInterruptTime . Tuttavia, l'aumento della risoluzione del timer non è consigliato perché può ridurre le prestazioni complessive del sistema e aumentare il consumo di energia del sistema impedendo al processore di immettere stati di risparmio energia. Al contrario, le applicazioni devono usare un timer ad alta risoluzione.

Nota La funzione QueryInterruptTime produce risultati diversi nelle build di Debug ("checked") di Windows, perché il conteggio dei tempi di interruzione e il conteggio dei tick sono avanzati di circa 49 giorni. Ciò consente di identificare i bug che potrebbero verificarsi fino a quando il sistema non è stato eseguito per molto tempo. La build selezionata è disponibile per i sottoscrittori MSDN tramite il sito Web MSDN (Microsoft Developer Network).

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0601 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2016 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	realtimeapiset.h
Libreria	Mincore.lib
DLL	Kernel32.dll