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

Voir aussi

FILETIME

FileTimeToDosDateTime

FileTimeToLocalFileTime

FileTimeToSystemTime

OpenThread

Fonctions de processus et de thread

Threads