GetThreadTimes, fonction (processthreadsapi.h)
Récupère les informations de minutage pour le thread spécifié.
Syntaxe
BOOL GetThreadTimes(
[in] HANDLE hThread,
[out] LPFILETIME lpCreationTime,
[out] LPFILETIME lpExitTime,
[out] LPFILETIME lpKernelTime,
[out] LPFILETIME lpUserTime
);
Paramètres
[in] hThread
Handle du thread dont les informations de minutage sont recherchées. Le handle doit avoir le droit d’accès THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION . Pour plus d’informations, consultez Sécurité des threads et droits d’accès.
Windows Server 2003 et Windows XP : Le handle doit avoir le droit d’accès THREAD_QUERY_INFORMATION .
[out] lpCreationTime
Pointeur vers une structure FILETIME qui reçoit l’heure de création du thread.
[out] lpExitTime
Pointeur vers une structure FILETIME qui reçoit l’heure de sortie du thread. Si le thread n’est pas arrêté, le contenu de cette structure n’est pas défini.
[out] lpKernelTime
Pointeur vers une structure FILETIME qui reçoit la durée d’exécution du thread en mode noyau.
[out] lpUserTime
Pointeur vers une structure FILETIME qui reçoit la durée d’exécution du thread en mode utilisateur.
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
Toutes les heures sont exprimées à l’aide de structures de données FILETIME . Une telle structure contient deux valeurs 32 bits qui se combinent pour former un nombre 64 bits d’unités de temps de 100 nanosecondes.
Les heures de création et de sortie des threads sont des points dans le temps exprimés sous la forme du temps écoulé depuis minuit le 1er janvier 1601 à Greenwich, en Angleterre. Il existe plusieurs fonctions qu’une application peut utiliser pour convertir ces valeurs en formulaires plus généralement utiles ; consultez Fonctions de temps.
Les durées du mode noyau de thread et du mode utilisateur sont des durées. Par exemple, si un thread a passé une seconde en mode noyau, cette fonction remplit la structure FILETIME spécifiée par lpKernelTime avec une valeur 64 bits de dix millions. C’est le nombre d’unités de 100 nanosecondes en une seconde.
Pour récupérer le nombre de cycles d’horloge du processeur utilisés par les threads, utilisez la fonction QueryThreadCycleTime .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |