Funzione QueryUnbiasedInterruptTimePrecise (realtimeapiset.h)

Articolo
11/20/2024

Ottiene il numero di interrupt-time non distorto corrente, in un formato più preciso rispetto a queryUnbiasedInterruptTime. Il conteggio tempo di interruzione non distorto non include il tempo trascorso dal sistema in sospensione o ibernazione.

Sintassi

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parametri

[out] lpUnbiasedInterruptTimePrecise

Puntatore a ULONGLONG in cui ricevere il conteggio tempo di interrupt non distorto in unità temporali 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 si basa 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 dell'orologio 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 interrupt 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 rispetto a 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 compilazioni di debug ("controllate") di Windows, perché il conteggio dei tempi di interrupt e il conteggio dei tick sono avanzati di circa 49 giorni. Ciò consente di identificare i bug che potrebbero non verificarsi fino a quando il sistema non è stato eseguito per molto tempo.

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.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10 [app desktop \| App UWP]
server minimo supportato	Windows Server 2016 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	realtimeapiset.h
libreria	mincore.lib
dll	Kernel32.dll