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

Vedere anche

QueryIdleProcessorCycleTime

QueryProcessCycleTime