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
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | realtimeapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| bibliothèque | Mincore.lib |
| DLL | Kernel32.dll |