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 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 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

Vedere anche

QueryIdleProcessorCycleTime

QueryProcessCycleTime