Funzione QueryProcessCycleTime (realtimeapiset.h)

Recupera la somma del tempo del ciclo di tutti i thread del processo specificato.

Sintassi

BOOL QueryProcessCycleTime(
  [in]  HANDLE   ProcessHandle,
  [out] PULONG64 CycleTime
);

Parametri

[in] ProcessHandle

Handle per il processo. 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 dai thread del processo. 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 processi nel sistema, usare la funzione EnumProcesses.

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

Vedere anche

QueryIdleProcessorCycleTime

QueryThreadCycleTime