KeConvertPerformanceCounterToAuxiliaryCounter-Funktion (wdm.h)

Artikel
02/07/2025

Die KeConvertPerformanceCounterToAuxiliaryCounter Routine konvertiert den angegebenen Leistungsindikatorwert in einen Hilfszählerwert.

Syntax

NTSTATUS KeConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONG64  PerformanceCounterValue,
  [out]           PULONG64 AuxiliaryCounterValue,
  [out, optional] PULONG64 ConversionError
);

Parameter

[in] PerformanceCounterValue

Der zu konvertierende Leistungsindikatorwert.

[out] AuxiliaryCounterValue

Ein Zeiger auf die Variable, die den konvertierten Hilfszählerwert enthält.

[out, optional] ConversionError

Ein Zeiger auf eine Variable, die den geschätzten Konvertierungsfehler in Einheiten von Nanosekunden enthält.

Rückgabewert

KeConvertPerformanceCounterToAuxiliaryCounter kann eine der folgenden Werte zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Konvertierung war erfolgreich.
STATUS_NOT_SUPPORTED	Hilfszähler wird nicht unterstützt.
STATUS_INVALID_PARAMETER	Der PerformanceCounterValue Wert ist ungültig. Beispielsweise liegt der Wert vor dem letzten Systemstart/der letzten Wiederherstellung oder außerhalb des Bereichs +/- 10s im Vergleich zum aktuellen Leistungsindikatorwert.
STATUS_UNSUCCESSFUL	Die Routine kann den angegebenen Wert nicht mit akzeptabler Genauigkeit konvertieren.

Bemerkungen

Stellen Sie sicher, dass der angegebene Leistungsindikatorwert wie folgt lautet:

Innerhalb von +/- 10s im Vergleich zum aktuellen Lesewert des Leistungsindikators.
Nicht vor dem aufgezeichneten Leistungsindikatorwert beim letzten Systemstart oder der Wiederherstellung vom S3/S4-Zustand.

Der ConversionError Wert ist der Unterschied in Nanosekunden zwischen dem erwarteten berechneten Wert und dem tatsächlich berechneten Wert für den Hilfszähler. Wenn der wert ConversionError größer als der erwartete Wert (bestimmt durch Sie) ist, rufen Sie die Routine erneut auf.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 10.
Zielplattform-	Universal
Header-	wdm.h
Library	Ntoskrnl.lib
DLL-	Hal.dll
IRQL-	Beliebige Ebene

Siehe auch

KeConvertAuxiliaryCounterToPerformanceCounter

Freigeben über