ConvertPerformanceCounterToAuxiliaryCounter-Funktion (realtimeapiset.h)

  • Artikel

Konvertiert den angegebenen Leistungsindikatorwert in den entsprechenden Hilfsindikatorwert; stellt optional den geschätzten Konvertierungsfehler in Nanosekunden aufgrund von Latenzen und maximal möglicher Abweichung bereit.

Syntax

HRESULT ConvertPerformanceCounterToAuxiliaryCounter(
  [in]            ULONGLONG  ullPerformanceCounterValue,
  [out]           PULONGLONG lpAuxiliaryCounterValue,
  [out, optional] PULONGLONG lpConversionError
);

Parameter

[in] ullPerformanceCounterValue

Der zu konvertierende Leistungsindikatorwert.

[out] lpAuxiliaryCounterValue

Enthält bei Erfolg den konvertierten Hilfsindikatorwert. Wird nicht definiert, wenn die Funktion fehlschlägt.

[out, optional] lpConversionError

Enthält bei Erfolg den geschätzten Konvertierungsfehler in Nanosekunden. Wird nicht definiert, wenn die Funktion fehlschlägt.

Rückgabewert

Gibt S_OK zurück, wenn die Konvertierung erfolgreich ist. Gibt andernfalls ein weiteres HRESULT zurück , das den Fehler angibt.

Rückgabewert BESCHREIBUNG
S_OK
 Die Funktion wurde erfolgreich ausgeführt.
E_NOTIMPL
 Der Hilfsindikator wird nicht unterstützt.
E_BOUNDS
 Der zu konvertierende Wert liegt außerhalb des zulässigen Bereichs (+/- 10 Sekunden nach dem Auftreten des aufgerufenen).
E_BOUNDS
 Der zu konvertierende Wert liegt vor dem letzten Systemstart oder S3/S4-Übergang.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1703 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile realtimeapiset.h
Bibliothek Mincore.lib
DLL Kernel32.dll