QueryInterruptTime-Funktion (realtimeapiset.h)

Artikel
07/16/2024

Ruft die aktuelle Unterbrechungszeitanzahl ab. Verwenden Sie für eine genauere Anzahl QueryInterruptTimePrecise.

Syntax

void QueryInterruptTime(
  [out] PULONGLONG lpInterruptTime
);

Parameter

[out] lpInterruptTime

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

Die Unterbrechungszeitanzahl beginnt bei Null, wenn das System beginnt und bei jeder Uhr um die Länge eines Taktstrichs erhöht wird. Die genaue Länge eines Taktstrichs hängt von der zugrunde liegenden Hardware ab und kann zwischen Systemen variieren.

Im Gegensatz zur Systemzeit unterliegt die Unterbrechungszeit nicht den Anpassungen durch Benutzer oder den Windows-Zeitdienst. Anwendungen können die Unterbrechungszeitanzahl verwenden, um feinere Dauer zu messen, als mit der Systemzeit möglich sind. Anwendungen, die eine höhere Genauigkeit als die Unterbrechungszeitanzahl erfordern, sollten einen hochauflösenden Timerverwenden. Verwenden Sie die QueryPerformanceFrequency-funktion, um die Häufigkeit des hochauflösenden Timers und der QueryPerformanceCounter--Funktion abzurufen, um den Wert des Zählers abzurufen.

Die zeitgeberauflösung, die durch die timeBeginPeriod und timeEndPeriod- Funktionen festgelegt wird, wirkt sich auf die Auflösung der QueryInterruptTime--Funktion aus. Das Erhöhen der Timerauflösung wird jedoch nicht empfohlen, da sie die Gesamtleistung des Systems reduzieren und den Stromverbrauch des Systems erhöhen kann, indem verhindert wird, dass der Prozessor Stromsparzustände eingibt. Stattdessen sollten Anwendungen einen hochauflösenden Timer verwenden.

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