Fonction KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

  • Article

La routine KeConvertPerformanceCounterToAuxiliaryCounter convertit la valeur du compteur de performances spécifiée en valeur auxiliaire de compteur.

Syntaxe

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

Paramètres

[in] PerformanceCounterValue

Valeur du compteur de performances à convertir.

[out] AuxiliaryCounterValue

Pointeur vers la variable qui contient la valeur de compteur auxiliaire convertie.

[out, optional] ConversionError

Pointeur vers une variable qui contient l’erreur de conversion estimée en unités de nanoseconde.

Valeur retournée

KeConvertPerformanceCounterToAuxiliaryCounter peut retourner l’un des éléments suivants :

Code de retour Description
STATUS_SUCCESS
 La conversion a réussi.
STATUS_NOT_SUPPORTED
 Le compteur auxiliaire n’est pas pris en charge.
STATUS_INVALID_PARAMETER
La valeur PerformanceCounterValue n’est pas valide. Par exemple, la valeur est antérieure au dernier démarrage/récupération système, ou est hors de la plage de +/- 10s par rapport à la valeur actuelle du compteur de performances.
STATUS_UNSUCCESSFUL
La routine ne peut pas convertir la valeur spécifiée avec une précision acceptable.

Remarques

Vérifiez que la valeur du compteur de performances spécifiée est :

  • Dans +/- 10 s par rapport à la valeur de lecture actuelle du compteur de performances.
  • Pas avant la valeur du compteur de performances enregistrée lors du dernier démarrage du système ou de la récupération à partir de l’état S3/S4.
La valeur ConversionError est la différence, en nanosecondes, entre la valeur calculée attendue et la valeur calculée réelle pour le compteur auxiliaire. Si la valeur ConversionError est supérieure à la valeur attendue (déterminée par vous), appelez à nouveau la routine.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Disponible à partir de Windows 10.
Plateforme cible Universal
En-tête wdm.h
Bibliothèque Ntoskrnl.lib
DLL Hal.dll
IRQL N’importe quel niveau

Voir aussi

KeConvertAuxiliaryCounterToPerformanceCounter