Fonction ConvertPerformanceCounterToAuxiliaryCounter (realtimeapiset.h)

  • Article

Convertit la valeur du compteur de performances spécifiée en valeur de compteur auxiliaire correspondante ; fournit éventuellement l’erreur de conversion estimée en nanosecondes en raison des latences et de la dérive maximale possible.

Syntaxe

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

Paramètres

[in] ullPerformanceCounterValue

Valeur du compteur de performances à convertir.

[out] lpAuxiliaryCounterValue

En cas de réussite, contient la valeur du compteur auxiliaire converti. Ne sera pas défini en cas d’échec de la fonction.

[out, optional] lpConversionError

En cas de réussite, contient l’erreur de conversion estimée, en nanosecondes. Ne sera pas défini en cas d’échec de la fonction.

Valeur retournée

Retourne S_OK si la conversion réussit ; sinon, retourne un autre HRESULT spécifiant l’erreur.

Valeur retournée Description
S_OK
 La fonction a réussi.
E_NOTIMPL
 Le compteur auxiliaire n’est pas pris en charge.
E_BOUNDS
 La valeur à convertir est en dehors de la plage autorisée (+/- 10 secondes à partir du moment où l’appelé s’est produit).
E_BOUNDS
 La valeur à convertir est antérieure au dernier démarrage du système ou à la transition S3/S4.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1703 [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2016 [applications de bureau | Applications UWP]
Plateforme cible Windows
En-tête realtimeapiset.h
Bibliothèque Mincore.lib
DLL Kernel32.dll