Fonction KeConvertPerformanceCounterToAuxiliaryCounter (wdm.h)

Article
02/29/2024

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

Partager via