Funzione QueryInterruptTimePrecise (realtimeapiset.h)

Articolo
07/16/2024

Ottiene il numero di interrupt-time corrente, in un formato più preciso di queryInterruptTime.

Sintassi

void QueryInterruptTimePrecise(
  [out] PULONGLONG lpInterruptTimePrecise
);

Parametri

[out] lpInterruptTimePrecise

Puntatore a ULONGLONG in cui ricevere il conteggio dei tempi di interrupt 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

queryInterruptTimePrecise è simile alla routine QueryInterruptTime, ma è più precisa. L'ora di interruzione segnalata da queryInterruptTime 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 queryInterruptTime è accurato all'interno di un tick dell'orologio di sistema.

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

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

Vedere anche osservazioni in QueryInterruptTime.

Nota La funzione QueryInterruptTimePrecise produce risultati diversi nelle build di debug ("controllate") 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 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