Funzione GetThreadTimes (processthreadsapi.h)
Recupera le informazioni sull'intervallo per il thread specificato.
Sintassi
BOOL GetThreadTimes(
[in] HANDLE hThread,
[out] LPFILETIME lpCreationTime,
[out] LPFILETIME lpExitTime,
[out] LPFILETIME lpKernelTime,
[out] LPFILETIME lpUserTime
);
Parametri
[in] hThread
Handle per il thread le cui informazioni di intervallo sono ricercate. L'handle deve avere il diritto di accesso THREAD_QUERY_INFORMATION o THREAD_QUERY_LIMITED_INFORMATION . Per altre informazioni, vedere Thread Security and Access Rights.For more information, see Thread Security and Access Rights.
Windows Server 2003 e Windows XP: L'handle deve avere il diritto di accesso THREAD_QUERY_INFORMATION .
[out] lpCreationTime
Puntatore a una struttura FILETIME che riceve l'ora di creazione del thread.
[out] lpExitTime
Puntatore a una struttura FILETIME che riceve l'ora di uscita del thread. Se il thread non è terminato, il contenuto di questa struttura non è definito.
[out] lpKernelTime
Puntatore a una struttura FILETIME che riceve il tempo di esecuzione del thread in modalità kernel.
[out] lpUserTime
Puntatore a una struttura FILETIME che riceve il tempo di esecuzione del thread in modalità utente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Tutte le volte vengono espresse usando strutture di dati FILETIME . Tale struttura contiene due valori a 32 bit che si combinano per formare un conteggio a 64 bit di unità di tempo di 100 nanosecondi.
I tempi di creazione e uscita dei thread sono punti nel tempo espressi come quantità di tempo trascorsa dalla mezzanotte del 1° gennaio 1601 a Greenwich, Inghilterra. Esistono diverse funzioni che un'applicazione può usare per convertire tali valori in forme più generalmente utili; vedere Funzioni temporali.
La modalità kernel del thread e i tempi della modalità utente sono quantità di tempo. Ad esempio, se un thread ha trascorso un secondo in modalità kernel, questa funzione riempirà la struttura FILETIME specificata da lpKernelTime con un valore a 64 bit di dieci milioni. Ovvero il numero di unità da 100 nanosecondi in un secondo.
Per recuperare il numero di cicli di clock della CPU usati dai thread, usare la funzione QueryThreadCycleTime .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | processthreadsapi.h (include Windows.h in Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |