Partager via

Fonction QueryThreadCycleTime (realtimeapiset.h)

  • Article

Récupère le temps de cycle du thread spécifié.

Syntaxe

BOOL QueryThreadCycleTime(
  [in]  HANDLE   ThreadHandle,
  [out] PULONG64 CycleTime
);

Paramètres

[in] ThreadHandle

Handle pour le thread. Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

[out] CycleTime

Nombre de cycles d’horloge du processeur utilisés par le thread. Cette valeur inclut les cycles passés en mode utilisateur et en mode noyau.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour énumérer les threads du processus, utilisez les fonctions Thread32First et Thread32Next . Pour obtenir le handle de thread d’un identificateur de thread, utilisez la fonction OpenThread .

N’essayez pas de convertir les cycles d’horloge du processeur retournés par QueryThreadCycleTime en temps écoulé. Cette fonction utilise les services de minuteur fournis par le processeur, qui peuvent varier dans l’implémentation. Par exemple, certains processeurs varient la fréquence du minuteur lors de la modification de la fréquence à laquelle le processeur s’exécute, tandis que d’autres la conservent à un taux fixe. Le comportement de chaque processeur est décrit dans la documentation fournie par le fournisseur du processeur.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête realtimeapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

QueryIdleProcessorCycleTime

QueryProcessCycleTime