Funzione QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Articolo
08/25/2023

Ottiene il conteggio del tempo di interruzione non modificato corrente, in forma più precisa rispetto a QueryUnbiasedInterruptTime . Il conteggio dei tempi di interruzione nonbiati non include il tempo trascorso dal sistema nel sonno o nell'ibernazione.

Sintassi

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parametri

[out] lpUnbiasedInterruptTimePrecise

Puntatore a ULONGLONG in cui ricevere il conteggio del tempo di interruzione non imparziale in 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

QueryUnbiasedInterruptTimePrecise è simile alla routine QueryUnbiasedInterruptTime , ma è più precisa. L'ora di interruzione segnalata da QueryUnbiasedInterruptTime è basata sul tick più recente del timer dell'orologio di sistema. Il timer dell'orologio di sistema è il timer hardware che genera periodicamente interrupt per l'orologio di sistema. Il periodo uniforme tra gli interrupt del timer di clock di sistema viene definito tick di clock di sistema ed è in genere compreso nell'intervallo di 0,5 millisecondi a 15,625 millisecondi, a seconda della piattaforma hardware. Il valore dell'ora di interruzione recuperato da QueryUnbiasedInterruptTime è accurato all'interno di un tick dell'orologio di sistema.

Per fornire un valore di ora di sistema più preciso di quello di QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise legge direttamente l'hardware timer, pertanto una chiamata QueryUnbiasedInterruptTimePrecise può essere più lenta di una chiamata QueryUnbiasedInterruptTime .

Chiamare la routine KeQueryTimeIncrement per determinare la durata di un tick dell'orologio di sistema.

Vedere anche osservazioni in QueryUnbiasedInterruptTime.

Nota La funzione QueryUnbiasedInterruptTimePrecise 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	Kernel32.lib
DLL	Kernel32.dll