QueryUnbiasedInterruptTimePrecise-Funktion (realtimeapiset.h)

Artikel
03/01/2024

Ruft die aktuelle Anzahl unvoreingenommener Interruptzeit in einer genaueren Form ab als QueryUnbiasedInterruptTime . Die Anzahl der unvoreingenommenen Unterbrechungen enthält keine Zeit, die das System im Ruhezustand oder im Ruhezustand verbringt.

Syntax

void QueryUnbiasedInterruptTimePrecise(
  [out] PULONGLONG lpUnbiasedInterruptTimePrecise
);

Parameter

[out] lpUnbiasedInterruptTimePrecise

Ein Zeiger auf einen ULONGLONG-Wert, in dem die Unvoreingenommene Interruptzeitanzahl in Systemzeiteinheiten von 100 Nanosekunden empfangen werden soll. Dividieren Sie durch zehn Millionen oder 1e7, um Sekunden zu erhalten (es gibt 1e9 Nanosekunden in einer Sekunde, also 1e7 100 Nanosekunden in einer Sekunde).

Rückgabewert

Keine

Bemerkungen

QueryUnbiasedInterruptTimePrecise ähnelt der QueryUnbiasedInterruptTime-Routine , ist aber präziser. Die von QueryUnbiasedInterruptTime gemeldete Interruptzeit basiert auf dem letzten Tick des Systemuhrtimers. Der Systemuhrtimer ist der Hardwaretimer, der regelmäßig Interrupts für die Systemuhr generiert. Der einheitliche Zeitraum zwischen Unterbrechungen des Systemuhrzeitgebers wird als Systemuhrtakt bezeichnet und liegt je nach Hardwareplattform in der Regel im Bereich von 0,5 Millisekunden bis 15,625 Millisekunden. Der von QueryUnbiasedInterruptTime abgerufene Interruptzeitwert ist innerhalb eines Systemuhrtakts genau.

Um einen Systemzeitwert bereitzustellen, der genauer als queryUnbiasedInterruptTime ist, liest QueryUnbiasedInterruptTimePrecise die Timerhardware direkt. Daher kann ein QueryUnbiasedInterruptTimePrecise-Aufruf langsamer sein als ein QueryUnbiasedInterruptTime-Aufruf .

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

Siehe auch Hinweise in QueryUnbiasedInterruptTime.

Hinweis Die QueryUnbiasedInterruptTimePrecise-Funktion erzeugt unterschiedliche Ergebnisse bei Debugbuilds ("überprüft") von Windows, da die Interruptzeitanzahl und die Anzahl der Teilstriche um ungefähr 49 Tage erweitert werden. Dies hilft, Fehler zu identifizieren, die möglicherweise erst auftreten, wenn das System über einen längeren Zeitraum ausgeführt wurde. Der überprüfte Build ist für MSDN-Abonnenten über die Msdn-Website (Microsoft Developer Network) verfügbar.

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
Unterstützte Mindestversion (Client)	Windows 10 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	realtimeapiset.h
Bibliothek	Kernel32.lib
DLL	Kernel32.dll