Freigeben über


KeQueryPerformanceCounter-Funktion (ntifs.h)

Die KeQueryPerformanceCounter-Routine ruft den aktuellen Wert und die Häufigkeit des Leistungsindikators ab.

Verwenden Sie KeQueryPerformanceCounter , um Zeitstempel mit hoher Auflösung (<1μs) für Zeitintervallmessungen abzurufen.

Syntax

NTHALAPI LARGE_INTEGER KeQueryPerformanceCounter(
  [out, optional] PLARGE_INTEGER PerformanceFrequency
);

Parameter

[out, optional] PerformanceFrequency

Ein Zeiger auf eine Variable, in die KeQueryPerformanceCounter die Leistungsindikatorhäufigkeit in Ticks pro Sekunde schreibt. Dieser Parameter ist optional und kann NULL sein, wenn der Aufrufer den Wert für die Zählerhäufigkeit nicht benötigt.

Rückgabewert

KeQueryPerformanceCounter gibt den Leistungsindikatorwert in Einheiten von Ticks zurück.

Hinweise

KeQueryPerformanceCounter gibt eine 64-Bit-Ganzzahl zurück, die den aktuellen Wert eines hochauflösenden monotonisch nicht erweiterenden Zählers darstellt.

Um die Häufigkeit des Leistungsindikators zu erhalten, geben Sie einen Nicht-NULL-Zeigerwert für den PerformanceFrequency-Parameter an. Die Häufigkeit des Leistungsindikators wird beim Systemstart festgelegt und ist für alle Prozessoren konsistent. Daher kann ein Treiber die Häufigkeit des Leistungsindikators während der Initialisierung zwischenspeichern.

Weitere Informationen zu dieser Funktion und ihrer Verwendung finden Sie unter Abrufen hochauflösender Zeitstempel.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Zielplattform Universell
Header ntifs.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek Hal.lib
DLL Hal.dll
IRQL Beliebige Ebene

Weitere Informationen

KeQueryInterruptTime

KeQueryTickCount

KeQueryTimeIncrement

QueryPerformanceCounter

QueryPerformanceFrequency