KeConvertPerformanceCounterToAuxiliaryCounter-Funktion (wdm.h)

  • Artikel

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