Freigeben über


QueryInterruptTimePrecise-Funktion (realtimeapiset.h)

Ruft die aktuelle Unterbrechungszeitanzahl in einer präziseren Form ab, als QueryInterruptTime- tut.

Syntax

void QueryInterruptTimePrecise(
  [out] PULONGLONG lpInterruptTimePrecise
);

Parameter

[out] lpInterruptTimePrecise

Ein Zeiger auf ein ULONGLONG,in dem die Unterbrechungszeitanzahl in Systemzeiteinheiten von 100 Nanosekunden empfangen wird. Dividieren Sie zehn Millionen oder 1e7, um Sekunden zu erhalten (es gibt 1e9 Nanosekunden in einer Sekunde, sodass es 1e7 100-Nanosekunden in einer Sekunde gibt).

Rückgabewert

Nichts

Bemerkungen

QueryInterruptTimePrecise ähnelt der QueryInterruptTime Routine, ist aber genauer. Die von QueryInterruptTime gemeldete Unterbrechungszeit basiert auf dem neuesten Teil des Systemuhrzeitgebers. Der Systemuhrzeitgeber ist der Hardwaretimer, der regelmäßig Unterbrechungen für die Systemuhr generiert. Der einheitliche Zeitraum zwischen Systemuhrzeitgeberunterbrechungen wird als Systemuhr-Tick bezeichnet und liegt in der Regel im Bereich von 0,5 Millisekunden bis 15,625 Millisekunden, je nach Hardwareplattform. Der von QueryInterruptTime abgerufene Unterbrechungszeitwert ist innerhalb eines Systemuhrstrichs genau.

Um einen Präziseren Systemzeitwert bereitzustellen, der präziser als QueryInterruptTime-ist, liest QueryInterruptTimePrecise die Zeitgeberhardware direkt aus, daher kann ein QueryInterruptTimePrecise- Aufruf langsamer sein als ein QueryInterruptTime- Aufruf.

Rufen Sie die KeQueryTimeIncrement Routine auf, um die Dauer eines Systemuhrstrichs zu bestimmen.

Siehe auch Hinweise in QueryInterruptTime.

Hinweis Die QueryInterruptTimePrecise Funktion erzeugt unterschiedliche Ergebnisse für Debugbuilds ("aktiviert") von Windows, da die Unterbrechungszeitanzahl und die Teilstrichanzahl um ca. 49 Tage erweitert werden. Dadurch können Fehler identifiziert werden, die möglicherweise erst auftreten, wenn das System lange ausgeführt wurde.
 
Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0601 oder höher. Weitere Informationen finden Sie unter Verwenden der Windows-Header.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows 10 [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform- Fenster
Header- realtimeapiset.h
Library Mincore.lib
DLL- Kernel32.dll

Siehe auch

Unterbrechungszeit

QueryInterruptTime-

QueryUnbiasedInterruptTime-

QueryUnbiasedInterruptTimePrecise

System-Power States

Windows Time