KeConvertPerformanceCounterToAuxiliaryCounter, fonction (wdm.h)

Article
02/07/2025

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

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 de retour

KeConvertPerformanceCounterToAuxiliaryCounter pouvez retourner l’une des options suivantes :

Retourner le code	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 du système, ou est hors de la plage +/- 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 la suivante :

Dans +/- 10 par rapport à la valeur de lecture actuelle du compteur de performances.
Pas plus tôt que la valeur du compteur de performances enregistrée au dernier démarrage ou récupération du système à 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible à partir de Windows 10.
plateforme cible	Universel
d’en-tête	wdm.h
bibliothèque	Ntoskrnl.lib
DLL	Hal.dll
IRQL	N’importe quel niveau

Voir aussi

KeConvertAuxiliaryCounterToPerformanceCounter

Partager via