QueryUnbiasedInterruptTimePrecise-Funktion (realtimeapiset.h)

Artikel
09/26/2024

Ruft die aktuelle unvoreingenommene Unterbrechungszeitanzahl in einer präziseren Form ab, als QueryUnbiasedInterruptTime- tut. Die unvoreingenommene Unterbrechungszeit umfasst nicht die Zeit, die das System im Ruhezustand oder im Ruhezustand verbringt.

Syntax

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parameter

[out] lpUnbiasedInterruptTimePrecise

Ein Zeiger auf ein ULONGLONG, in dem die unvoreingenommene 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

QueryUnbiasedInterruptTimePrecise ähnelt der QueryUnbiasedInterruptTime Routine, ist aber präziser. Die von QueryUnbiasedInterruptTime 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 QueryUnbiasedInterruptTime abgerufene Unterbrechungszeitwert ist innerhalb eines Systemuhrstrichs genau.

Um einen Systemzeitwert bereitzustellen, der präziser ist als der von QueryUnbiasedInterruptTime, QueryUnbiasedInterruptTimePrecise liest die Zeitgeberhardware direkt, daher kann ein QueryUnbiasedInterruptTimePrecise Aufruf langsamer sein als ein QueryUnbiasedInterruptTime Aufruf.

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

Siehe auch Hinweise in QueryUnbiasedInterruptTime.

Hinweis Die QueryUnbiasedInterruptTimePrecise-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