QueryThreadCycleTime, fonction (realtimeapiset.h)

Récupère l’heure du cycle pour le thread spécifié.

Syntaxe

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

Paramètres

[in] ThreadHandle

Handle vers le thread. Le handle doit disposer du droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Processus de sécurité et de droits d’accès.

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

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’erreur étendues, 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 du minuteur fournis par l’UC, qui peuvent varier en implémentation. Par exemple, certaines UC varient selon la fréquence du minuteur lors de la modification de la fréquence à laquelle l’UC s’exécute et d’autres le laisseront à un débit fixe. Le comportement de chaque UC est décrit dans la documentation fournie par le fournisseur du processeur.

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

Exigences

Voir aussi

QueryIdleProcessorCycleTime

queryProcessCycleTime