Fonction QueryThreadCycleTime (realtimeapiset.h)
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour