Funzione QueryIdleProcessorCycleTime (realtimeapiset.h)
Recupera il tempo del ciclo per il thread inattiva di ogni processore nel sistema.
In un sistema con più di 64 processori, questa funzione recupera il tempo di ciclo per il thread inattiva di ogni processore nel gruppo di processori a cui viene assegnato il thread chiamante. Usare la funzione QueryIdleProcessorCycleTimeEx per recuperare il tempo di ciclo per il thread inattiva in ogni processore logico per un gruppo di processori specifico.
Sintassi
BOOL QueryIdleProcessorCycleTime(
[in, out] PULONG BufferLength,
[out] PULONG64 ProcessorIdleCycleTime
);
Parametri
[in, out] BufferLength
In input specifica le dimensioni del buffer ProcessorIdleCycleTime in byte. Questo buffer dovrebbe essere 8 volte il numero di processori nel gruppo.
Nell'output specifica il numero di elementi scritti nel buffer. Se le dimensioni del buffer non sono sufficienti, la funzione ha esito negativo e questo parametro riceve la lunghezza richiesta del buffer.
[out] ProcessorIdleCycleTime
Numero di cicli di clock della CPU usati da ogni thread inattivo. Questo buffer deve essere 8 volte il numero di processori nelle dimensioni del sistema.
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 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
gruppi di processori