Funzione QueryThreadCycleTime (realtimeapiset.h)
Recupera il tempo del ciclo per il thread specificato.
Sintassi
BOOL QueryThreadCycleTime(
[in] HANDLE ThreadHandle,
[out] PULONG64 CycleTime
);
Parametri
[in] ThreadHandle
Handle per il thread. L'handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION. Per altre informazioni, vedere Process Security and Access Rights.
[out] CycleTime
Numero di cicli di clock della CPU usati dal thread. Questo valore include cicli spesi sia in modalità utente che in modalità kernel.
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 ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
Per enumerare i thread del processo, usare le funzioni Thread32First e Thread32Next. Per ottenere l'handle di thread per un identificatore di thread, usare la funzione
Non tentare di convertire i cicli di clock della CPU restituiti da QueryThreadCycleTime in tempo trascorso. Questa funzione usa i servizi timer forniti dalla CPU, che possono variare nell'implementazione. Ad esempio, alcune CPU variano la frequenza del timer quando si modifica la frequenza con cui viene eseguita la CPU e altre lo lasceranno a una velocità fissa. Il comportamento di ogni CPU è descritto nella documentazione fornita dal fornitore della CPU.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versione successiva.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2008 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
realtimeapiset.h (include Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| libreria |
Mincore.lib |
| dll | Kernel32.dll |