Funzione GetThreadTimes (processthreadsapi.h)

Articolo
08/25/2023

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