KeConvertPerformanceCounterToAuxiliaryCounter-Funktion (wdm.h)

Artikel
03/01/2024

Die KeConvertPerformanceCounterToAuxiliaryCounter-Routine konvertiert den angegebenen Leistungsindikatorwert in einen Hilfsindikatorwert.

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 Hilfsindikatorwert enthält.

[out, optional] ConversionError

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

Rückgabewert

KeConvertPerformanceCounterToAuxiliaryCounter kann folgendes zurückgeben:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Konvertierung war erfolgreich.
STATUS_NOT_SUPPORTED	Hilfsindikator wird nicht unterstützt.
STATUS_INVALID_PARAMETER	Der PerformanceCounterValue-Wert ist ungültig. Beispielsweise ist der Wert früher als der letzte Start/Wiederherstellung des Systems oder liegt im Vergleich zum aktuellen Leistungsindikatorwert außerhalb des +/- 10s-Bereichs.
STATUS_UNSUCCESSFUL	Die Routine kann den angegebenen Wert nicht mit akzeptabler Genauigkeit konvertieren.

Hinweise

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

Innerhalb von +/- 10s im Vergleich zum aktuellen Lesewert des Leistungsindikators.
Nicht früher als der aufgezeichnete Leistungsindikatorwert beim letzten Start oder Wiederherstellung des Systems aus dem S3/S4-Zustand.

Der ConversionError-Wert ist der Unterschied zwischen dem erwarteten berechneten Wert und dem tatsächlichen berechneten Wert für den Hilfsindikator in Nanosekunden. Wenn der ConversionError-Wert größer als der erwartete Wert ist (von Ihnen bestimmt), rufen Sie die Routine erneut auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 10.
Zielplattform	Universell
Header	wdm.h
Bibliothek	Ntoskrnl.lib
DLL	Hal.dll
IRQL	Beliebige Ebene

Weitere Informationen

KeConvertAuxiliaryCounterToPerformanceCounter

Freigeben über