Funzione QueryIdleProcessorCycleTime (realtimeapiset.h)

Recupera il tempo di 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 pari a 8 volte il numero di processori nel gruppo.

Nell'output specifica il numero di elementi scritti nel buffer. Se la dimensione del buffer non è sufficiente, la funzione ha esito negativo e questo parametro riceve la lunghezza necessaria del buffer.

[out] ProcessorIdleCycleTime

Numero di cicli di clock della CPU usati da ogni thread inattiva. Questo buffer deve essere 8 volte il numero di processori nella dimensione 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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0600 o versioni successive.

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 (includono Windows.h in Windows 7, Windows Server 2008 Windows Server 2008 R2)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Gruppi di processori

QueryIdleProcessorCycleTimeEx

QueryProcessCycleTime

QueryThreadCycleTime