Funzione QueryThreadCycleTime (realtimeapiset.h)
Recupera l'ora 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 Sicurezza dei processi e diritti di accesso.
[out] CycleTime
Numero di cicli di clock della CPU usati dal thread. Questo valore include i 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 informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
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 OpenThread .
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 altri 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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2008 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | realtimeapiset.h (include Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |