Funzione QueryIdleProcessorCycleTimeEx (realtimeapiset.h)

  • Articolo

Recupera il tempo di ciclo accumulato per il thread inattiva in ogni processore logico nel gruppo di processori specificato.

Sintassi

BOOL QueryIdleProcessorCycleTimeEx(
  [in]      USHORT   Group,
  [in, out] PULONG   BufferLength,
  [out]     PULONG64 ProcessorIdleCycleTime
);

Parametri

[in] Group

Numero del gruppo di processori per cui recuperare il tempo del ciclo.

[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. Se questo parametro è NULL, la funzione aggiorna il parametro BufferLength con la lunghezza richiesta.

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 sull'errore estese, usare GetLastError.

Commenti

Per compilare un'applicazione che usa questa funzione, impostare _WIN32_WINNT = 0x0601 >. Per altre informazioni, vedere Uso delle intestazioni di Windows.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione realtimeapiset.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Gruppi di processori

QueryIdleProcessorCycleTime